dg_seek(3C)                    DG/UX 5.4R3.00                    dg_seek(3C)


NAME
       dgseek, dgblockseek - extended seek functions

SYNOPSIS
       #include <sys/dgcgenerics.h>

       booleantype dgseek (int fildes, uint high, uint low);

       booleantype dgblockseek (int fildes, ulong block);

DESCRIPTION
       Dgseek performs an extended seek operation to a device whose offsets
       are too large to be handled by lseek(2).  Dgseek will use the values
       high and low to form a 64 bit file position value with respect to
       position zero in the file.  The current file position for fildes is
       then set to this value.  High is the top 32 bits of the device
       address and low is the bottom 32 bits of the device address.

       Dgblockseek will use block to create a 64 bit file position value,
       using 512-byte blocks as the block size.  The current file position
       for fildes is then set to this value.


   Considerations for Threads Programming
                   +--------------+-----------------------------+
                   |              |                      async- |
                   |function      | reentrant   cancel   cancel |
                   |              |              point    safe  |
                   +--------------+-----------------------------+
                   |dgblockseek |     Y          Y        N   |
                   |dgseek       |     Y          Y        N   |
                   +--------------+-----------------------------+

SEE ALSO
       lseek(2), reentrant(3).

DIAGNOSTICS
       Both functions return TRUE (1 as defined in <sys/dg_c_generics.h>)
       when the seek is successful, and FALSE (0 as defined in
       <sys/dg_c_generics.h>) when unsuccessful.  Calling this function on
       an invalid file descriptor will also result in a FALSE result.
















Licensed material--property of copyright holder(s)                         1