NAME

       gspool_jobfind - get the details of a job from the job number

       gspool_jobfindslot - get the slot number of a job from the job number

SYNOPSIS

       #include <gspool.h>

       int gspool_jobfind(const int fd , const unsigned flags, const jobno_t jobnum, const netid_t nid, slotno_t
       *slot, struct apispq *jobd)

       int gspool_jobfindslot(const int fd , const unsigned flags, const jobno_t jobnum, const netid_t nid,
       slotno_t *slot)

DESCRIPTION

       The gspool_jobfind() and gspool_jobfindslot functions may be used to find a job from a given job number
       rather than by the slot number. gspool_jobfind retrieves the job descriptor, gspool_jobfindslot just
       retrieves the slot number.

       fd is a file descriptor previously returned by gspool_open

       flags is zero, or a logical OR of one or more of the following values

       GSPOOL_FLAG_LOCALONLY
           Ignore remote printers/hosts, i.e. not local to the server, not the client.

       GSPOOL_FLAG_USERONLY
           Ignore other users jobs

       jobnum is the job number to be searched for.

       nid is the network-byte order IP address of the host of the machine whose job is to be searched for. This
       should be correct even if "GSPOOL_FLAG_LOCALONLY" is specified.

       slot  is  a  pointer  to  a  location  in  which  the  slot  number of the job is placed if the search is
       successfull. It may be "NULL"  if  this  is  not  required  (but  this  would  be  almost  pointless  for
       gspool_jobfindslot).

       jobd  is  a descriptor containing the job descriptor as defined in gspool.h.  The fields in struct apispq
       are defined in the documentation for gspool_jobread(3).

RETURN VALUES

       The functions gspool_jobfind() and gspool_jobfindslot return  0  if  successful,  otherwise  one  of  the
       following codes:

       GSPOOL_UNKNOWN_JOB
               job not found

       GSPOOL_INVALID_FD
               Invalid File descriptor

       GSPOOL_BADWRITE
               failure writing to the network

       GSPOOL_BADREAD
               failure reading from the network

SEE ALSO

       gspool_jobread(3),     gspool_joblist(3),    gspool_jobdata(3),    gspool_jobadd(3),    gspool_jobdel(3),
       gspool_jobupd(3), gspool_jobmon(3), gspool_jobpbrk(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.

GNUspool Release 1                                 2009-05-30                                  gspool_jobfind(3)