Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9747 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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
	      associated 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  XpSetLocale‐
       Hinter)	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>  con‐
       tains:

       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)

Vote for polarhome