umount(2) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

umount(2)

umount(2)                        System Calls                        umount(2)

NAME
       umount, umount2 - unmount a file system

SYNOPSIS
       #include <sys/mount.h>

       int umount(const char *file);


       int umount2(const char *file, int mflag);

DESCRIPTION
       The  umount()  function  requests that a previously mounted file system
       contained on a block special device or directory be unmounted. The file
       argument is a pointer to the absolute pathname of the file system to be
       unmounted. After unmounting the file system, the directory  upon  which
       the file system was mounted reverts to its ordinary interpretation.


       The  umount2()  function  is identical to umount(), with the additional
       capability of unmounting file systems even if there are open files  ac‐
       tive. The mflag argument must contain one of the following values:

       0           Perform  a  normal  unmount that is equivalent to umount().
                   The umount2() function returns  EBUSY  if  there  are  open
                   files active within the file system to be unmounted.


       MS_FORCE    Unmount  the  file system, even if there are open files ac‐
                   tive. A forced unmount can result in loss of  data,  so  it
                   should be used only when a regular unmount is unsuccessful.
                   The  umount2()  function  returns  ENOTSUP if the specified
                   file systems does not support MS_FORCE. Only  file  systems
                   of type nfs, ufs, pcfs, and zfs support MS_FORCE.


RETURN VALUES
       Upon  successful  completion,  0 is returned. Otherwise, −1 is returned
       and errno is set to indicate the error.

ERRORS
       The umount() and umount2() functions will fail if:

       EACCES          The permission bits of the mount point  do  not  permit
                       read/write  access  or search permission is denied on a
                       component of the path prefix.

                       The calling process is not the owner of the mountpoint.

                       The mountpoint is not a regular file or a directory and
                       the caller does not have all privileges available in  a
                       its zone.

                       The  special  device device does not permit read access
                       in the case of read-only mounts or read-write access in
                       the case of read/write mounts.


       EBUSY           A file on file is busy.


       EFAULT          The file pointed to by file points to  an  illegal  ad‐
                       dress.


       EINVAL          The file pointed to by file is not mounted.


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


       ENAMETOOLONG    The  length  of  the file argument exceeds PATH_MAX, or
                       the length of a file component exceeds  NAME_MAX  while
                       _POSIX_NO_TRUNC is in effect.


       ENOENT          The file pointed to by file does not exist or is not an
                       absolute path.


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


       ENOTBLK         The file pointed to by file is not a block special  de‐
                       vice.


       EPERM           The  {PRIV_SYS_MOUNT}  privilege is not asserted in the
                       effective set of the calling process.


       EREMOTE         The file pointed to by file is remote.



       The umount2() function will fail if:

       ENOTSUP    The file pointed to by file does not support this operation.


USAGE
       The umount() and umount2() functions can be invoked only by  a  process
       that has the {PRIV_SYS_MOUNT} privilege asserted in its effective set.


       Because  it  provides  greater functionality, the umount2() function is
       preferred.

SEE ALSO
       mount(2), privileges(7)

Oracle Solaris 11.4               4 Aug 2008                         umount(2)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3