umount(2)                                                         umount(2)

NAME
     umount - unmount a file system

SYNOPSIS
     #include <sys/mount.h>

     int umount(const char*file);

DESCRIPTION
     umount() requests that a previously mounted file system contained on
     the block special file or directory identified by file be unmounted.
     file is a pointer to a path name. After unmounting the file system,
     the directory upon which the file system was mounted reverts to its
     ordinary interpretation.

     umount() may be invoked only by the superuser.

     umount() will fail if one or more of the following apply:

     EPERM         The process' effective user ID is not superuser.

     EINVAL        file does not exist.

     ELOOP         Too many symbolic links were encountered in translating
                   the path pointed to by file.

     ENAMETOOLONG  The length of the file argument exceeds PATHMAX or the
                   length of a file component exceeds NAMEMAX.

     ENOTBLK       file is not a block special file.

     EINVAL        file is not mounted.

     EBUSY         A file on file is busy.

     EFAULT        file points to an illegal address.

     EREMOTE       file is a remote pathname.

     ENOLINK       file is on a remote machine, and the link to that
                   machine is no longer active.

     EMULTIHOP     Components of the path pointed to by file require hop-
                   ping to multiple remote machines.

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

SEE ALSO
     mount(2).




Page 1                       Reliant UNIX 5.44                Printed 11/98