uvmount

Purpose

     Unmounts a device, directory, or file.

Syntax

     int uvmount (stubpath)
     char *stubpath;

Description

     The uvmount  system call unmounts the  device, directory,
     or file that is mounted on stubpath.  The stubpath param-
     eter points to  a path name.  If  Distributed Services is
     installed on your system, this  path can lead to a remote
     node.

     To issue a uvmount  system call, this process's effective
     user ID  must be superuser,  or the process must  own the
     stubpath  directory  and  have write  permission  on  the
     parent directory of the stubpath.

     After  the  uvmount  system   call  has  been  completed,
     stubpath  reverts to  its  previous  interpretation as  a
     directory or file.

Return Value

     Upon  successful  completion,  the  uvmount  system  call
     returns a value of 0.   If the uvmount system call fails,
     a value of  -1 is returned, and errno is  set to indicate
     the error.

Diagnostics

     The uvmount system call fails if  one or more of the fol-
     lowing are true:

     EBUSY         A  device that  is  still in  use is  being
                   unmounted.

     EPERM         The  process's  effective  user ID  is  not
                   superuser nor is this  process the owner of
                   the stubpath directory,  with write permis-
                   sion on the parent directory.

     EINVAL        There is nothing mounted on stubpath.

     EFAULT        stubpath &pointsout..

     ESTALE        The process's root  or current directory is
                   located in  a virtual file system  that has
                   been unmounted.

     If  Distributed Services  is  installed  on your  system,
     uvmount can also fail if one or more of the following are
     true:

     EDIST         The   server   has  blocked   new   inbound
                   requests.

     EDIST         Outbound requests are currently blocked.

     EDIST         The server has a  release level of Distrib-
                   uted Services that  cannot communicate with
                   this node.

     EAGAIN        The  server  is  too  busy  to  accept  the
                   request.

     ESTALE        The file  descriptor for a remote  file has
                   become obsolete.

     EPERM         The translate tables of  the server did not
                   contain any entry  for either the effective
                   user  ID  or  effective  group  ID  of  the
                   calling process.

     ENODEV        The named file is  a remote file located on
                   a  device that  has been  unmounted at  the
                   server.

     ENOMEM        Either  this node  or the  server does  not
                   have enough memory available to service the
                   request.

     ENOCONNECT    An attempt to establish  a new network con-
                   nection with a remote node failed.

     EBADCONNECT   An attempt to use  an existing network con-
                   nection with a remote node failed.

Related Information

     In  this book:   "mntctl," "mount,"   "umount," "vmount,"
     and  "master."

     The  mount and  umount commands  in AIX  Operating System
     Commands Reference.