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

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