vunlock(3)                          CLIX                          vunlock(3)



  NAME

    vunlock - Unlocks an area of memory

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    int vunlock(
      int key ,
      int flag );

  PARAMETERS

    key    Specifies a unique identifier returned by vlock().

    flag   If this parameter is set, the page reference and modify bits are
           cleared for all pages contained fully in the address range.  This
           action will invalidate any data associated with these pages.

  DESCRIPTION

    The vunlock() function is the page-unlocking mechanism for memory locked
    with vlock().  The key is a unique identifier returned by vlock().

    If flag is set, the page reference and modify bits are cleared for all
    pages contained fully in the address range.  This action will invalidate
    any data associated with these pages.

    The vunlock() function fails if one or more of the following is true:

    [EINVAL]   The key is not a valid key.

    [EPERM]    The process attempting to unlock the area is not the same
               process that locked the area.

  CAUTIONS

    Any pages within a shared memory region that were locked by vlock() must
    be unlocked before the region is detached.

  RETURN VALUES

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

  RELATED INFORMATION

    Function:  vlock(2)



  2/94 - Intergraph Corporation                                              1