XpSetAttributes − Sets or updates an attribute pool in the specified print context.


cc [ flag... ] file... -lXp [ library... ]

#include <X11/extensions/Print.h>

void XpSetAttributes ( display, context, type, pool, replacement_rule )
Display *display;
XPContext context;
XPAttributes type;
char *pool;
XPAttrReplacement replacement_rule;



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


The print context whose attribute pool is to be modified.


Specifies the attribute pool.


An attribute pool represented as a resource string. Encoded in COMPOUND_TEXT.


Either XPAttrReplace orXPAttrMerge.


XpSetAttributes accepts pool, a COMPOUND_TEXT resource string representing new name-value pairs for the attribute pool specified by type. The attribute pool is modified by the new name-value pairs according to replacement_rule. For XPAttrReplace, the existing attribute pool is discarded and replaced with pool. For XPAttrMerge, pool is merged into the existing attribute pool; pre-existing name-value pairs are replaced, and non-existing name-value pairs are added. The contents of pool is not affected by this call, and can be freed by the caller afterwards.

When setting supported attribute names, the X Print Server and associated driver will validate the new values and ignore those that are invalid; previous values remain unchanged. When setting unsupported (that is, unknown) attribute names, no validation is done, and the name-value pairs will be set, even though they will not be used. When deleting (that is, failing to reset with XPAttrReplace) a supported attribute name, the X Print Server explicitly or implicitly resets the attribute to a default value.

When setting certain supported attributes, the X Print Server may modify other associated attributes. For example, considering the XPPrinterAttr attribute document-formats-supported, setting the XPDocAttr attribute document-format may cause a number of other attributes to change.

For attribute pools that are read-only (see "get only" in XPAttributes definition), attempting to use XpSetAttributes generates a BadMatch. For attribute pools that are writable, lists of the supported attributes can be found in the XPPrinterAttr pool.

The lifetime of all attribute pools are bounded by the lifetime of the print context they are contained in. When set, all attribute values will be retained across all Xp operations, until changed by the user directly, the X Print Server directly, or changed because of a side effect when either the user or X Print Server changed another attribute value.

Refer to a complete description of all print attributes, the precedence between print attributes, and the side effects of setting certain print attributes on other print attributes, etc.

To monitor changes to the attribute pools, see XpSelectInput and the event XPAttributeNotify. Since a print context can be shared among clients, changes made by one client will be seen by all others, and if selected for, the event XPAttributeNotify will be sent to all clients referencing the print context when changes do occur. It is the responsibility of the clients sharing a print context to coordinate their operations.


The values for the typedef XPAttributes in <X11/extensions/Print.h> are:

#define XPJobAttr 1 /∗ get/set */

#define XPDocAttr


/∗ get/set */
#define XPPageAttr


/∗ get/set - subset of XPDocAttr */
#define XPPrinterAttr


/∗ get only (library) */
#define XPServerAttr


/∗ get only (library), no context needed */

The values for the typedef XPAttrReplacement in <X11/extensions/Print.h> are:

#define XPAttrReplace

#define XPAttrMerge




Insufficient memory.


The attribute pool specified by pool cannot be set.


The value specified for type is not valid.


The specified print context-id is not valid.


A request to set an attribute pool occurred at a time when the attribute pool could not be modified (for example, modifying XPJobAttr immediately after calling XpStartJob).




XpSelectInput(3Xp), XpStartJob(3Xp)

More Linux Commands

XtSetWMColormapWindows(3) - Set the value of the WM_COLORMAP
XtSetWMColormapWindows returns immediately if widget is not realized or if count is zero. Otherwise, XtSetWMColormapWindows constructs an ordered list of window

gnutls_pcert_import_openpgp_raw(3) - API function (ManPage)
gnutls_pcert_import_openpgp_raw.3 - This convenience function will import the given certificate to a gnutls_pcert_st structure. The structure must be deinitiali

XGetScreenSaver(3) - manipulate the screen saver (Man Page)
Timeout and interval are specified in seconds. A timeout of 0 disables the screen saver (but an activated screen saver is not deactivated), and a timeout of -1

keytool-java-1.7.0-openjdk(1) (Commands - Linux man page)...
keytool-java-1.7.0-openjdk.1 - keytool is a key and certificate management utility. It allows users to administer their own public/private key pairs and associa

klogd(8) - Kernel Log Daemon (Admin - Linux man page).......
klogd is a system daemon which intercepts and logs Linux kernel messages. OPTIONS -c n Sets the default log level of console messages to n. -d Enable debugging

termname(3ncurses) - curses environment query routines......
The baudrate routine returns the output speed of the terminal. The number returned is in bits per second, for example 9600, and is an integer. The erasechar rou

pcre32_compile(3) Perl-compatible regular expressions.......
This function compiles a regular expression into an internal form. It is the same as pcre[16|32]_compile2(), except for the absence of the errorcodeptr argument

swaplabel(8) - print or change the label or UUID of a swap a
swaplabel will display or change the label or UUID of a swap partition located on device (or regular file). If the optional arguments -L and -U are not given, s

idmap_ldap(8) - Samba's idmap_ldap Backend for Winbind......
The idmap_ldap plugin provides a means for Winbind to store and retrieve SID/uid/gid mapping tables in an LDAP directory service. In contrast to read only backe

XtProcessEvent(3) - query and process events and input......
XtNextEvent has been replaced by XtAppNextEvent. XtPeekEvent has been replaced by XtAppPeekEvent. XtPending has been replaced by XtAppPending. XtProcessEvent ha

aclocal-1.11(1) - manual page for aclocal 1.11.1 (Man Page)
Generate aclocal.m4 by scanning configure.ac or configure.in OPTIONS --acdir=DIR directory holding config files (for debugging) --diff[=COMMAND] run COMMAND [di

chooser(1) - X Display Manager with support for XDMCP, host
Xdm manages a collection of X displays, which may be on the local host or remote servers. The design of xdm was guided by the needs of X terminals as well as Th

We can't live, work or learn in freedom unless the software we use is free.