vlock(3)                            CLIX                            vlock(3)



  NAME

    vlock - Locks an area of memory

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    int vlock(
      int addr ,
      int length );

  PARAMETERS

    addr     Specifies the virtual address of the area of memory to be locked.

    length   Specifies the length in bytes of the area of memory to be locked.

  DESCRIPTION

    The vlock() function is a page-locking mechanism.  The area of memory to
    be locked starts at the virtual address addr and is length bytes long.
    The vlock function returns a unique key which is used to identify the area
    to be unlocked by vunlock().

  CAUTIONS

    The addr variable cannot be 0.

  RETURN VALUES

    Upon successful completion, a unique key is returned.  Otherwise, a value
    of -1 is returned and errno is set to indicate the error.

  ERRORS

    The global variable errno is set to indicate errors when vlock() returns a
    -1 value, such as when any of the following are true:

    [EFAULT]   The range of addresses specified are not valid.

    [EAGAIN]   The necessary resources are not available at this time.

  RELATED INFORMATION

    Functions:  vunlock(2)






  2/94 - Intergraph Corporation                                              1