SCOptions(3)

NAME
     SCOptions, SCHasOptions - scanner specific options

SYNOPSIS
     #include <stdio.h>
     #include <scanner.h>

     int SCOptions(SCANNER *s);

     int SCHasOptions(SCANNER *s);

DESCRIPTION
     SCOptions starts the scanner specific options program for s.  A scanner
     specific options program provides a user interface allowing the user to
     set scanning parameters that are not a part of the libscan(3) interface.
     The options program communicates directly with the scanner driver to set
     scanner specific options, so no further interaction is required by the
     scanning program.

     SCHasOptions is used to determine whether or not a scanner specific
     options program exists for the scanner s.

     In both functions, s specifies a connection with a scanner driver
     obtained by a call to SCOpen(3), SCOpenFile(3), or SCOpenScreen(3).

RETURN VALUE
     SCOptions returns 0 if it successfully started the scanner specific
     options program, and -1 if an error occurred.  If an error occurs,
     SCOptions sets SCerrno to indicate the reason for the error.

     SCHasOptions returns 1 if the scanner has a scanner specific options
     program, and 0 otherwise.

EXECUTION ERROR CODES
     SCOptions will fail under the following circumstances.

     SCENOOPTIONS             No options for this scanner

     SCEALREADYOPTIONS        Options are already running for this scanner

     In addition, SCOptions may fail as the result of a failed system call, in
     which case SCerrno will be set to a value from <sys/errno.h>.  SCOptions
     calls the fork(2) and execl(2) system calls.

SEE ALSO
     libscan(3), SCOpen(3), fork(2), exec(2).