NAME

XGetWMClientMachine — get a window’s XA_WM_CLIENT_MACHINE property. 

SYNOPSIS

Status XGetWMClientMachine(display, w, text_prop_return)
   Display ∗display;
   Window w;
   XTextProperty ∗text_prop_return;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the window. 

text_prop_return
Returns the XTextProperty structure that describes the machine the client is running on. 

RETURNS

Zero on failure, non-zero on success. 

AVAILABILITY

Release 4 and later. 

DESCRIPTION

XGetWMClientMachine() performs an XGetTextProperty() to get the WM_CLIENT_MACHINE property of the specified window.  This property should contain the name of the host machine on which this client is being run, as seen from the server.  This function returns non-zero status in success; otherwise it returns a zero status. 

This function is normally used along with XGetCommand() by a session manager or window manager to get complete information on how to reinvoke an application. 

For more information, see Volume One, Chapter 10, Interclient Communication. 

STRUCTURES

typedef struct {
    unsigned char ∗value;          /∗ same as Property routines ∗/
    Atom encoding;                 /∗ prop type ∗/
    int format;                    /∗ prop data format: 8, 16, or 32 ∗/
    unsigned long nitems;          /∗ number of data items in value ∗/ } XTextProperty;

SEE ALSO

XSetWMClientMachine(), XGetCommand(). 

Xlib Reference Manual