gspool_jobfind(3)
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 ggssppooooll__jjoobbffiinndd(()) 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.