libscan(3)

LIBRARY DESCRIPTION
     libscan provides a C Language application programming interface (API) for
     scanners.  Application programs that use libscan can retrieve data from
     any scanning device for which a corresponding scanner driver exists.

LIBRARY ACCESS
     Programs that call libscan functions must include the stdio.h and
     scanner.h header files located in the /usr/include directory.  In
     addition, the programs must link with the libscan.a and libmpc.a
     libraries located in /usr/lib.

FUNCTIONS
     Information about installed scanners
                    SCSetScanEnt
                    SCGetScanEnt
                    SCEndScanEnt

     Getting the default scanner name
                    SCDefaultScannerName

     Opening a scanning device
                    SCOpen
                    SCOpenScreen
                    SCOpenFile
                    SCClose

     Scanner specific options
                    SCOptions
                    SCHasOptions

     Scanner information
                    SCScannerName
                    SCGetMinMaxRes
                    SCGetScannerRes
                    SCGetPageSize
                    SCGetDataTypes

     Scanning state
                    SCSetup
                    SCScan
                    SCScanFD
                    SCAbort
                    SCGetStatus
                    SCGetStatusFD
                    SCGetSaveOptions
                    SCSetSaveOptions

     Scan data      SCGetScanLine
                    SCGetScanSize
                    SCGetFD
                    SCDataReady
     Document Feeder
                    SCFeederGetFlags
                    SCFeederSetFlags
                    SCFeederAdvance
                    SCFeederReady

     Events         SCGetEventFD
                    SCEventPending
                    SCGetEvent

SIGNAL HANDLING (SIGCLD)
     libscan spawns child processes to execute scanner drivers and scanner
     specific options programs.  Some libscan functions terminate these child
     processes; within these functions, SIGCLD is blocked and libscan waits on
     the children.

     It is possible that a scanner driver or a scanner specific options
     program will terminate asynchronously.  Applications using libscan should
     be prepared to handle the SIGCLD signal.  libscan uses the POSIX signal
     handling and wait interfaces.

SEE ALSO
     scanners(1M), gscan(1), sigprocmask(2), sigaction(2), waitpid(2),
     intro(3).