gspool_ptradd(3)

NAME
gspool_ptradd - add a new printer

SYNOPSIS
#include <gspool.h>

int gspool_ptradd(const int fd, struct apispptr *ptrd)

DESCRIPTION
The function gspool_ptradd() is used to create a printer.

fd is a file descriptor previously returned by gspool_open

ptrd is a "struct apispptr" describing the details of the printer. It is defined in the file gspool.h. The fields in struct apispptr are defined in the documentation for gspool_ptrread(3).

Only values for the name, device, formtype, description, local flag, the minimun and maximum job sizes, the network filter flag and the class code are accepted. All other parameters are ignored. We suggest that you clear all fields to zero before starting. Future releases with additional fields will be guaranteed to default to the existing behaviour if the additional fields are set to zero.

RETURN VALUES
Xt_ptradd returns zero if successful, otherwise an error code will be returned according to the reason for failure. Error codes which might be returned are:

GSPOOL_INVALID_FD
    Invalid file descriptor

GSPOOL_BADWRITE
    failure writing to network

GSPOOL_BADREAD
    failure reading from network

GSPOOL_NOPERM
    User does not have permission to add printers

GSPOOL_BAD_FORM
    invalid form type

EXAMPLE
An example to add a printer called "hplj1" on device "/dev/tty12" with form type "a4"

 int fd, ret;
 struct apispptr ptr;

 fd = gspool_open("myhost", (char *) 0, 0);
 if (fd < 0) { /* error handling */
     ...
 }

 memset((void *) &ptr, '\0', sizeof(ptr));
 ptr.apispp_class = 0xffffffff;
 ptr.apispp_minsize = ptr.apispp_maxsize = 0;
 strcpy(ptr.apispp_ptr, "hplj1");
 strcpy(ptr.apispp_form, "a4");
 strcpy(ptr.apispp_dev, "tty12");
 strcpy(ptr.apispp_comment, "My new printer");
 ret = gspool_ptradd(fd, &ptr);
 if (ret < 0) { /* error handling */
     ...
 }

 gspool_close(fd);

SEE ALSO
gspool_ptrread(3), gspool_ptrdel(3), gspool_ptrfind(3), gspool_ptrfindslot(3), gspool_ptrupd(3), gspool_ptrmon(3), gspool_ptrop(3).

COPYRIGHT
Copyright (c) 2009 Free Software Foundation, Inc. This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

AUTHOR
John M Collins, Xi Software Ltd.