Solaris Trusted Extensions Reference Manual

X Library Extensions

XTSOLgetClientAttributes(3XTSOL)

NAME

XTSOLgetClientAttributes – get all label attributes associated with a client

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetClientAttributes(display, windowid, clientattr);

Display *display;
XID windowid;
XTsolClientAttributes *clientattrp;

Description

XTSOLgetClientAttributes() is used to get all label attributes that are associated with a client in a single call. The attributes include process ID, user ID, IP address, audit flags and session ID.

Parameters

display: Specifies a pointer to the Display structure. Is returned from XOpenDisplay().
windowid: Specifies window ID of X client.
clientattrp: Client must provide a pointer to an XTsolClientAttributes structure.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadValue: Not a valid client

XTSOLgetPropAttributes(3XTSOL)

NAME

XTSOLgetPropAttributes – get the label attributes associated with a property hanging on a window

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetPropAttributes(display, window, property, propattrp);

Display *display;
Window window;
Atom property;
XTSOLPropAttributes *propattrp;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetPropAttributes() is used to get the label attributes that are associated with a property hanging out of a window in a single call. The attributes include UID and sensitivity label.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of a window system object.
property: Specifies the property atom.
propattrp: Client must provide a pointer to XTSOLPropAttributes.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadAtom: Not a valid atom

XTSOLgetPropLabel(3XTSOL)

NAME

XTSOLgetPropLabel – get the label associated with a property hanging on a window

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetPropLabel(display, window, property, sl);

Display *display;
Window window;
Atom property;
m_label_t *sl;

Description

Client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetPropLabel() is used to get the sensitivity label that is associated with a property hanging on a window.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of the window whose property's label you want to get.
property: Specifies the property atom.
sl: Returns a sensitivity label that is the current label of the specified property.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadAtom: Not a valid atom

XTSOLgetPropUID(3XTSOL)

NAME

XTSOLgetPropUID – get the UID associated with a property hanging on a window

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetPropUID (display, window, property, uidp);
Display *display;
Window window;
Atom property;
uid_t *uidp;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetPropUID() gets the ownership of a window's property. This allows a client to get the ownership of an object it did not create.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of the window whose property's UID you want to get.
property: Specifies the property atom.
uidp: Returns a UID which is the current UID of the specified property. Client needs to provide a uid_t type storage and passes the address of this storage as the function argument. Client must provide a pointer to uid_t.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadAtom: Not a valid atom

XTSOLgetResAttributes(3XTSOL)

NAME

XTSOLgetResAttributes – get all label attributes associated with a window or a pixmap

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetResAttributes(display, object, type, winattrp);

Display *display;
XID object;
ResourceType type;
XTSOLResAttributes *winattrp;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetResAttributes() is used to get all label attributes that are associated with a window or a pixmap in a single call. The attributes include UID, sensitivity label, and workstation owner.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
object: Specifies the ID of a window system object. Possible window system objects are windows and pixmaps.
type: Specifies what type of resource is being accessed. Possible values are IsWindow and IsPixmap.
winattrp: Client must provide a pointer to XTSOLResAttributes.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadPixmap: Not a valid pixmap
BadValue: Not a valid type

XTSOLgetResLabel(3XTSOL)

NAME

XTSOLgetResLabel – get the label associated with a window, a pixmap, or a colormap

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetResLabel(display, object, type, sl);

Display *display;
XID object;
ResourceType type;
m_label_t *sl;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetResLabel() is used to get the label that is associated with a window or a pixmap or a colormap.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
object: Specifies the ID of a window system object whose label you want to get. Possible window system objects are windows, pixmaps, and colormaps.
type: Specifies what type of resource is being accessed. Possible values are IsWindow, IsPixmap or IsColormap.
sl: Returns a sensitivity label which is the current label of the specified object.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadPixmap: Not a valid pixmap
BadValue: Not a valid type

XTSOLgetResUID(3XTSOL)

NAME

XTSOLgetResUID – get the UID associated with a window, a pixmap

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetResUID(display, object, type, uidp);

Display *display;
XID object;
ResourceType type;
uid_t *uidp;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges.

XTSOLgetResUID() gets the ownership of a window system object. This allows a client to get the ownership of an object that the client did not create.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
object: Specifies the ID of a window system object whose UID you want to get. Possible window system objects are windows or pixmaps.
type: Specifies what type of resource is being accessed. Possible values are IsWindow and IsPixmap.
uidp: Returns a UID which is the current UID of the specified object. Client must provide a pointer to uid_t.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadPixmap: Not a valid pixmap
BadValue: Not a valid type

XTSOLgetSSHeight(3XTSOL)

NAME

XTSOLgetSSHeight – get the height of screen stripe

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetSSHeight(display, screen_num, newheight);

Display *display;
int screen_num;
int *newheight;

Description

XTSOLgetSSHeight() gets the height of trusted screen stripe at the bottom of the screen. Currently the screen stripe is only present on the default screen. Client must have the Trusted Path process attribute.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
screen_num: Specifies the screen number.
newheight: Specifies the storage area where the height of the stripe in pixels is returned.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadValue: Not a valid screen_num or newheight

XTSOLgetWorkstationOwner(3XTSOL)

NAME

XTSOLgetWorkstationOwner – get the ownership of the workstation

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLgetWorkstationOwner(display, uidp);

Display *display;
uid_t *uidp;

Description

XTSOLgetWorkstationOwner() is used to get the ownership of the workstation.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
uidp: Returns a UID which is the current UID of the specified Display workstation server. Client must provide a pointer to uid_t.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None.

Errors

BadAccess: Lack of privilege

XTSOLIsWindowTrusted(3XTSOL)

NAME

XTSOLIsWindowTrusted – test if a window is created by a trusted client

Synopsis

#include <X11/extensions/Xtsol.h>

Bool XTSOLIsWindowTrusted(display, window);

Display *display;
Window window;

Description

XTSOLIsWindowTrusted() tests if a window is created by a trusted client. The window created by a trusted client has a special bit turned on. The client does not require any privilege to perform this operation.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of the window to be tested.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

True: If the window is created by a trusted client.

Errors

BadWindow: Not a valid window.

SunOS 5.10 Last Revised 26 Jun 2006

XTSOLMakeTPWindow(3XTSOL)

NAME

XTSOLMakeTPWindow – make this window a Trusted Path window

Synopsis

 #include <X11/extensions/Xtsol.h>

Status XTSOLMakeTPWindow(display, w);

Display *display;
Window w;

Description

XTSOLMakeTPWindow() is used to make a window a trusted path window. Trusted Path windows always remain on top of other windows. The client must have the Trusted Path process attribute set.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
w: Specifies the ID of a window.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadValue: Not a valid type

SunOS 5.10 Last Revised 26 Jun 2006

XTSOLsetPolyInstInfo(3XTSOL)

NAME

XTSOLsetPolyInstInfo – set polyinstantiation information

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetPolyInstInfo(display, sl, uidp, enabled);

Display *display;
m_label_t sl;
uid_t *uidp;
int enabled;

Description

XTSOLsetPolyInstInfo() sets the polyinstantiated information to get property resources. By default, when a client requests property data for a polyinstantiated property, the data returned corresponds to the SL and UID of the requesting client. To get the property data associated with a property with specific sl and uid a client can use this call to set the SL and UID with enabled flag to TRUE. The client should also restore the enabled flag to FALSE after retrieving the property value. Client must have the PRIV_WIN_MAC_WRITE and PRIV_WIN_DAC_WRITE privileges.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
sl: Specifies the sensitivity label.
uidp: Specifies the pointer to UID.
enabled: Specifies whether client can set the property information retrieved.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadValue: Not a valid display or sl.

XTSOLsetPropLabel(3XTSOL)

NAME

XTSOLsetPropLabel – set the label associated with a property hanging on a window

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetPropLabel(*display, window, property, *sl);

Display *display;
Window window;
Atom property;
m_label_t *sl;

Description

XTSOLsetPropLabel() is used to change the sensitivity label that is associated with a property hanging on a window. The client must have the PRIV_WIN_DAC_WRITE, PRIV_WIN_MAC_WRITE, and PRIV_WIN_UPGRADE_SL privileges.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of the window whose property's label you want to change.
property: Specifies the property atom.
sl: Specifies a pointer to a sensitivity label.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadAtom: Not a valid atom
BadValue: Not a valid sl

XTSOLsetPropUID(3XTSOL)

NAME

XTSOLsetPropUID – set the UID associated with a property hanging on a window

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetPropUID(display, window, property, uidp);

Display *display;
Window window;
Atom property;
uid_t *uidp;

Description

XTSOLsetPropUID() changes the ownership of a window's property. This allows another client to modify a property of a window that it did not create. The client must have the PRIV_WIN_DAC_WRITE and PRIV_WIN_MAC_WRITE privileges.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
window: Specifies the ID of the window whose property's UID you want to change.
property: Specifies the property atom.
uidp: Specifies a pointer to a uid_t that contains a UID.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadAtom: Not a valid atom

XTSOLsetResLabel(3XTSOL)

NAME

XTSOLsetResLabel – set the label associated with a window or a pixmap

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetResLabel(display, object, type, sl);

Display *display;
XID object;
ResourceType type;
m_label_t *sl;

Description

The client must have the PRIV_WIN_DAC_WRITE, PRIV_WIN_MAC_WRITE, PRIV_WIN_UPGRADE_SL, and PRIV_WIN_DOWNGRADE_SL privileges.

XTSOLsetResLabel() is used to change the label that is associated with a window or a pixmap.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
object: Specifies the ID of a window system object whose label you want to change. Possible window system objects are windows and pixmaps.
type: Specifies what type of resource is being accessed. Possible values are IsWindow and IsPixmap.
sl: Specifies a pointer to a sensitivity label.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadPixmap: Not a valid pixmap
BadValue: Not a valid type or sl

XTSOLsetResUID(3XTSOL)

NAME

XTSOLsetResUID – set the UID associated with a window, a pixmap, or a colormap

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetResUID(display, object, type, uidp);

Display *display;
XID object;
ResourceType type;
uid_t *uidp;

Description

The client must have the PRIV_WIN_DAC_WRITE and PRIV_WIN_MAC_WRITE privileges. XTSOLsetResUID() changes the ownership of a window system object. This allows a client to create an object and then change its ownership. The new owner can then make modifications on this object as this object being created by itself.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
object: Specifies the ID of a window system object whose UID you want to change. Possible window system objects are windows and pixmaps.
type: Specifies what type of resource is being accessed. Possible values are: IsWindow and IsPixmap.
uidp: Specifies a pointer to a uid_t structure that contains a UID.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadWindow: Not a valid window
BadPixmap: Not a valid pixmap
BadValue: Not a valid type

XTSOLsetSessionHI(3XTSOL)

NAME

XTSOLsetSessionHI – set the session high sensitivity label to the window server

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetSessionHI(display, sl);

Display *display;
m_label_t *sl;

Description

XTSOLsetSessionHI() After the session high label has been set by a Trusted Extensions window system TCB component, logintool, Xsun will reject connection request from clients running at higher sensitivity labels than the session high label. The client must have the PRIV_WIN_CONFIG privilege.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
sl: Specifies a pointer to a sensitivity label to be used as the session high label.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege

XTSOLsetSessionLO(3XTSOL)

NAME

XTSOLsetSessionLO – set the session low sensitivity label to the window server

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetSessionLO(display, sl);

Display *display;
m_label_t *sl;

Description

XTSOLsetSessionLO() sets the session low sensitivity label. After the session low label has been set by a Trusted Extensions window system TCB component, logintool, Xsun will reject a connection request from a client running at a lower sensitivity label than the session low label. The client must have the PRIV_WIN_CONFIG privilege.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay().
sl: Specifies a pointer to a sensitivity label to be used as the session low label.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege

XTSOLsetSSHeight(3XTSOL)

NAME

XTSOLsetSSHeight – set the height of screen stripe

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetSSHeight(display, screen_num, newheight);

Display *display;
int screen_num;
int newheight;

Description

XTSOLsetSSHeight() sets the height of the trusted screen stripe at the bottom of the screen. Currently the screen stripe is present only on the default screen. The client must have the Trusted Path process attribute.

Parameters

display: Specifies a pointer to the Display structure; returned from XOpenDisplay.
screen_num: Specifies the screen number.
newheight: Specifies the height of the stripe in pixels.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege
BadValue: Not a valid screen_num or newheight.

XTSOLsetWorkstationOwner(3XTSOL)

NAME

XTSOLsetWorkstationOwner – set the ownership of the workstation

Synopsis

#include <X11/extensions/Xtsol.h>

Status XTSOLsetWorkstationOwner(display, uidp);

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

Description

XTSOLsetWorkstationOwner() 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.

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.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwts
MT-Level	MT-Unsafe

Return Values

None

Errors

BadAccess: Lack of privilege

X Library Extensions

XTSOLgetClientAttributes(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetPropAttributes(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetPropLabel(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetPropUID(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetResAttributes(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetResLabel(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetResUID(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetSSHeight(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values

Errors

See Also

XTSOLgetWorkstationOwner(3XTSOL)

NAME

Synopsis

Description

Parameters

Attributes

Return Values