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 gspool_jobread(3) documentation.


RETURN VALUES

The function returns 0 if successful otherwise one of the error codes listed in Chapter 3.


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).


AUTHOR

John M Collins, Xi Software Ltd.