NAME    [Toc]    [Back]

       umount - Unmount a file system

SYNOPSIS    [Toc]    [Back]

       #include <sys/mount.h>

       int unmount(
               char *spec );

LIBRARY    [Toc]    [Back]

       System V Compatibility Library (libsys5.a)

PARAMETERS    [Toc]    [Back]

       Points  to the pathname of the special file or file system
       to be unmounted.

DESCRIPTION    [Toc]    [Back]

       The umount() function unmounts a  previously-mounted  file
       system  contained  on the block special file pointed to by
       the spec parameter. When the file system is unmounted, the
       directory  mount  point  where the file system was mounted
       returns to its normal interpretation.

       The umount() function can only be  invoked  by  the  superuser.

NOTES    [Toc]    [Back]

       Two  umount()  functions  are  supported by the Tru64 UNIX
       operating system:  the  BSD  umount()  and  the  System  V
       umount().   The  default  umount()  function  is  the  BSD
       umount() . To use the version of  umount()  documented  on
       this  reference  page,  you  must  link  with  the libsys5
       library before you link with libc.

ERRORS    [Toc]    [Back]

       If the umount() function fails, errno may be set to one of
       the following values: The effective user ID of the calling
       process is not root.  The spec parameter points to a pathname
  that does not exist.  A component of the path prefix
       of spec is not a directory.  The device identified by spec
       is  not  a block-special device.  The device identified by
       spec does not exist.  A file on the device pointed  to  by
       the  spec parameter is busy.  The device pointed to by the
       spec parameter is not mounted.

RETURN VALUE    [Toc]    [Back]

       The umount() function returns 0 (zero) if the file  system
       was  successfully unmounted. Otherwise, -1 is returned and
       errno is set to indicate the error.

SEE ALSO    [Toc]    [Back]

       Commands: mount(8)



                                                        umount(3)