SCOptions(3) Impressario 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 ALSOlibscan(3), SCOpen(3), fork(2), exec(2).
Page 1
