printerdb man page on NeXTSTEP

Man page or keyword search:  
man Server   1419 pages
apropos Keyword Search (all sections)
Output format
NeXTSTEP logo
[printable version]


PRINTERDB(3)							  PRINTERDB(3)

NAME
       prdb_set,  prdb_get,  prdb_getbyname,  prdb_end	- get printer database
       entry

SYNOPSIS
       #include <printerdb.h>

       void prdb_set(char *domain);

       prdb_ent *prdb_get(void);

       prdb_ent *prdb_getbyname(const char *name);

       void prdb_end(void);

DESCRIPTION
       These routines retrieve information from the  printer  entry  database.
       prdb_getbyname  is  useful  for looking up a single printer entry.  The
       other routines are  used	 for  getting  all  of	the  printer  entries.
       prdb_set	 initializes  the  library  to	point  to the beginning of the
       printer entry list.  prdb_get returns the next printer entry,  or  NULL
       for  end of list.  prdb_end is called to free up any resources that may
       have been allocated during lookups. The following  example  illustrates
       how these latter three routines are typically used:

	      prdb_ent *prdb;
	      prdb_set(NULL);
	      while (prdb = prdb_get()) {
		   handle(prdb);
	      }
	      prdb_end();

       The  structure  returned	 by  prdb_getbyname and prdb_get is defined as
       follows:

	      typedef struct prdb_property {
		   char *pp_key;
		   char *pp_value;
	      } prdb_property;

	      typedef struct prdb_ent {
		   char **pe_name;
		   unsigned pe_nprops;
		   prdb_property *pe_prop;
	      } prdb_ent;

       pe_name the name of the printer entry.	pe_nprops  is  the  number  of
       members	of  this printer entry.	 pe_props is an array of prdb_property
       structures,  which  each	 contain  the  name  and  value	 for   various
       properties  of  the printer. See printcap(5) for a description of these
       values.

       A call to any of the printerdb(3) routines invalidates the  information
       returned from a previous call.

SEE ALSO
       printcap(5)

BUGS
       The  domain  argument to prdb_set() is ignored. It should always be set
       to NULL for compatibility with future releases.

7th Edition			 June 21, 1989			  PRINTERDB(3)
[top]

List of man pages available for NeXTSTEP

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net