Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xprehashprinterlist(3xp) [x11r4 man page]

XpRehashPrinterList(3Xp)					 XPRINT FUNCTIONS					  XpRehashPrinterList(3Xp)

NAME
XpRehashPrinterList - Recomputes the list of available printers. SYNOPSIS
cc [ flag... ] file... -lXp [ library... ] #include <X11/extensions/Print.h> void XpRehashPrinterList ( display ) Display *display; ARGUMENTS
display Specifies a pointer to the Display structure; returned from XOpenDisplay. DESCRIPTION
XpRehashPrinterList causes the X Print Server to recompute (update) its list of available printers, and update the attributes for the printers. The intended usage of this routine is in a special tool that a system administrator can run after changing the printer topology. General applications are encouraged to use this call sparingly if at all, and let the system administrator control printer topology updates. Depending on the print facilities underlying the X Print Server, the X Print Server may be able to detect changes in the printer topology and dynamically update to reflect the changes, or may not be able to detect the changes and will have to be notified via XpRehashPrint- erList. Existing print contexts will not be affected by XpRehashPrinterList as long as their printer destination remains valid. X Version 11 libXp 1.0.0 XpRehashPrinterList(3Xp)

Check Out this Related Man Page

XpGetPrinterList(3Xp)						 XPRINT FUNCTIONS					     XpGetPrinterList(3Xp)

NAME
XpGetPrinterList - Retrieves a list of all printers supported on an X Print Server. SYNOPSIS
cc [ flag... ] file... -lXp [ library... ] #include <X11/extensions/Print.h> XPPrinterList XpGetPrinterList ( display, printer_name, list_count_return ) Display *display; char *printer_name; int *list_count_return; ARGUMENTS
display Specifies a pointer to the Display structure; returned from XOpenDisplay. printer_name Specifies the name of the printer for which information is desired. If NULL, then information is returned for all printers associ- ated with the server. list_count_return Returns the number of printers in the list. DESCRIPTION
XpGetPrinterList returns a list of printer records where each record describes a printer supported by the X Print Server, or NULL if any errors occur. If printer_name is NULL, then a list of all printers supported is returned. If printer_name is non-NULL, only print records matching printer_name are returned, and if no records match printer_name , then NULL is returned. printer_name is a COMPOUND_TEXT string, and the name and desc fields in the returned list will be in COMPOUND_TEXT (note, ISO 8859-1 (Latin-1) is a proper subset of COMPOUND_TEXT, so can be used directly). If printer_name is in a code-set that the X Print Server cannot convert (into its operating code-set), then the X Print Server may fail to locate the requested printer. If printer_name is NULL, then all printer names, regardless of their code-set, can be returned, leaving the task of specific printer recognition up to the caller. When XpGetPrinterList is called, the caller's locale (see XpSetLocaleHinter) is included in the request as a "hint" to the X Print Server. If supported by the implementation, the X Print Server will use the hint to locate a localized description for each printer in the list. If the X Print Server cannot understand the hint, the X Print Server will choose a default. The returned printer list can be freed by calling XpFreePrinterList. The XPPrinterList structure defined in <X11/extensions/Print.h> contains: typedef struct { char *name; /* name */ char *desc; /* localized description */ } XPPrinterRec, *XPPrinterList; DIAGNOSTICS
BadAlloc Insufficient memory. SEE ALSO
XpFreePrinterList(3Xp), XpSetLocaleHinter(3Xp) X Version 11 libXp 1.0.0 XpGetPrinterList(3Xp)
Man Page