hpux man page for xgetwmclientmachine

XGetWMClientMachine()													     XGetWMClientMachine()

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
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies 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 rein-
  voke an application.

  For more information, see Volume One, Chapter 12, 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 - Window Manager Hints												     XGetWMClientMachine()