SCScan(3)

NAME
     SCScan, SCScanFD - start scanning from a scanning device.

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

     int SCScan(SCANNER *s);

     int SCScanFD(SCANNER *s, int fd);

DESCRIPTION
     SCScan tells the scanner driver to start scanning.  s specifies a
     connection to a scanner driver established by a call to SCOpen,
     SCOpenFile, or SCOpenScreen.  The scan data is then retrieved by calling
     SCGetScanLine(3) or SCGetScanFD(3).

     SCScanFD tells the scanner driver to start scanning, with the scan data
     being written directly to fd.  libscan will pass the file descriptor to
     the scanner driver, and the scanner driver will write the scan data
     directly to the file descriptor.

     Before calling either of these functions, SCSetup(3) and SCGetScanSize(3)
     should be called.

RETURN VALUE
     SCScan and SCScanFD return 0 if successful.  If an error occurs, -1 is
     returned and SCerrno is set to indicate the reason for failure.

EXECUTION ERROR CODES
     SCScan and SCScanFD will fail under the following circumstances.

     SCECOMM                  Error communicating with scanner driver

     SCEDEV                   Scanner driver error

     SCEDRVMSG                Driver specific error.  SCErrorString(3) will
                              return a custom message supplied by the scanner
                              driver

SEE ALSO
     libscan(3), SCOpen(3), SCSetup(3), SCGetScanSize(3).