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


NAME
       dg_seek, dg_block_seek - extended seek functions

SYNOPSIS
       #include <sys/dg_c_generics.h>

       boolean_type dg_seek (int fildes, uint high, uint low);

       boolean_type dg_block_seek (int fildes, ulong block);

DESCRIPTION
       Dg_seek performs an extended seek operation to a device whose offsets
       are too large to be handled by lseek(2).  Dg_seek 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.

       Dg_block_seek 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  |
                   +--------------+-----------------------------+
                   |dg_block_seek |     Y          Y        N   |
                   |dg_seek       |     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