XTSOLsetWorkstationOwner(3XTSOL)		 Trusted Extensions to X Windows Library Functions		  XTSOLsetWorkstationOwner(3XTSOL)

NAME

       XTSOLsetWorkstationOwner - set the ownership of the workstation

SYNOPSIS

       cc [flag...] file... -lX11 -lXtsol [library...]
       #include <X11/extensions/Xtsol.h>

       Status XTSOLsetWorkstationOwner(display, uidp);

       Display *display;
       uid_t *uidp;
       XTSOLClientAttributes *clientattrp;

PARAMETERS

       display	  Specifies a pointer to the Display structure; returned from XOpenDisplay().

       uidp	  Specifies a pointer to a uid_t structure that contains a UID.

DESCRIPTION

       The  XTSOLsetWorkstationOwner()	function  is  used by the Solaris Trusted Extensions logintool to assign a user ID to be identified as the
       owner of the workstation server. The client running under this user ID can set the server's device objects, such as keyboard mapping, mouse
       mapping, and modifier mapping. The client must have the Trusted Path process attribute.

RETURN VALUES

       None.

ERRORS

       BadAccess    Lack of privilege.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +---------------------------+-------------------------------+
       |      ATTRIBUTE TYPE	   |	    ATTRIBUTE VALUE	   |
       +---------------------------+-------------------------------+
       |Interface Stability	   | Committed			   |
       +---------------------------+-------------------------------+
       |MT-Level		   | Unsafe			   |
       +---------------------------+-------------------------------+

SEE ALSO

       libXtsol(3LIB), XTSOLgetWorkstationOwner(3XTSOL), attributes(5)

       Accessing and Setting a Workstation Owner ID in Solaris Trusted Extensions Developer's Guide

NOTES

       The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

SunOS 5.11							    20 Jul 2007 				  XTSOLsetWorkstationOwner(3XTSOL)