lockfs(8) 맨 페이지 - 윈디하나의 솔라나라

개요

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

lockfs(8)

lockfs(8)               System Administration Commands               lockfs(8)

NAME
       lockfs - change or report UFS file system locks

SYNOPSIS
       /usr/sbin/lockfs [-adefhnuw] [-c string] [file-system]...

DESCRIPTION
       lockfs  is used to change and report the status of file system locks on
       UFS file systems. lockfs reports the lock status and unlocks  the  file
       systems that were improperly left locked.


       Using lockfs to lock a file system is discouraged because this requires
       extensive  knowledge of Oracle Solaris internals to be used effectively
       and correctly.


       When invoked with no arguments, lockfs lists the UFS file systems  that
       are  locked.  If  file-system  is  not  specified, and -a is specified,
       lockfs is run on all mounted, UFS type file systems.

OPTIONS
       The options are mutually exclusive: wndheuf. If  you  do  specify  more
       than  one  of  these options on a lockfs command line, the utility does
       not protest and invokes only the last option specified. In  particular,
       you  cannot  specify  a  flush (-f) and a lock (for example, -w) on the
       same command line. However, all locking operations implicitly perform a
       flush, so the -f is superfluous when specifying a lock.


       You must have the {PRIV_SYS_MOUNT} privilege to use any of the  follow‐
       ing options, with the exception of -a, -f and -v.


       The following options are supported.

       -a

           Apply command to all mounted, UFS type file systems. file-system is
           ignored when -a is specified.


       -c string

           Accept  a  string  that is passed as the comment field. The -c only
           takes affect when the lock is being set using the -d, -h,  -n,  -u,
           or -w options.


       -d

           Delete-lock  (dlock)  the specified file-system. dlock suspends ac‐
           cess that could remove directory entries.


       -e

           Error-lock (elock) the specified file-system. elock blocks all  lo‐
           cal access to the locked file system and returns EWOULDBLOCK on all
           remote  access. File systems are elocked by UFS on detection of in‐
           ternal inconsistency. They may only be  unlocked  after  successful
           repair   by   fsck,   which  is  usually  done  automatically  (see
           mount_ufs(8)). elocked file systems can be unmounted.


       -f

           Force a synchronous flush of all data that is dirty at the time fs‐
           flush is run to its backing store for the named file system (or for
           all file systems.)

           It is a more reliable method than using sync(8) because it does not
           return until all possible data has been pushed. In the case of  UFS
           filesystems with logging enabled, the log is also rolled before re‐
           turning. Additional data can be modified by the time fsflush exits,
           so using one of the locking options is more likely to be of general
           use.


       -h

           Hard-lock (hlock) the specified file-system. hlock returns an error
           on  every access to the locked file system, and cannot be unlocked.
           hlocked file systems can be unmounted.


       -n

           Name-lock (nlock) the specified  file-system.  nlock  suspends  ac‐
           cesses that could change or remove existing directories entries.


       -u

           Unlock  (ulock)  the specified file-system. ulock awakens suspended
           accesses.


       -v

           Enable verbose output.


       -w

           Write-lock (wlock) the specified file-system. wlock suspends writes
           that would modify the file system. Access times are not kept  while
           a file system is write-locked.


OPERANDS
       The following operands are supported.

       file-system

           A list of path names separated by whitespace. Note that file-system
           can  be a directory rather than the specific name of a file system,
           such as / or /usr. For example, if you specify /export/home  as  an
           argument  to  a  lockfs  command and /export/home is mounted on the
           root (/) file system, the lockfs command will take  effect  on  the
           root file system.


EXAMPLES
       Example 1 Using lockfs -a




       In the following examples, filesystem is the pathname of the mounted-on
       directory  (mount point). Locktype is one of "write", "name", "delete",
       "hard", or "unlock". When enclosed in parenthesis, the  lock  is  being
       set.  Comment  is  a  string set by the process that last issued a lock
       command.



       The following example shows the lockfs output when only the  -a  option
       is specified.


         example#  /usr/sbin/lockfs -a



       tab();  lw(1.83i) lw(1.83i) lw(1.83i) FilesystemLocktypeComment /unlock
       /varunlock



         example#


       Example 2 Using lockfs -w



       The following example shows the lockfs output when  the  -w  option  is
       used  to  write lock the /var file system and the comment string is set
       using the -c option. The -a option is then specified on a separate com‐
       mand line.


         example#  /usr/sbin/lockfs -w -c "lockfs: write lock example" /var
         example#  /usr/sbin/lockfs -a



       tab(); lw(1.83i) lw(1.83i) lw(1.83i) FilesystemLocktypeComment  /unlock
       /varwritelockfs: write lock example



         example#


       Example 3 Using lockfs -u



       The  following  example  shows  the lockfs output when the -u option is
       used to unlock the /var file system and the comment string is set using
       the -c option.


         example#  /usr/sbin/lockfs -uc "lockfs: unlock example" /var
         example#  /usr/sbin/lockfs /var



       tab(); lw(1.83i) lw(1.83i) lw(1.83i) FilesystemLocktypeComment  /varun‐
       locklockfs: unlock example



         example#


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/file-system/ufs


SEE ALSO
       kill(1), ufs(4FS), attributes(7), privileges(7), mount_ufs(8), sync(8)

DIAGNOSTICS
       file system: Insufficient privileges

           The user does not have permission for the requested operation.


       file system: Deadlock condition detected/avoided

           A file is enabled for accounting or swapping, on file system.


       file system: Device busy

           Another process is setting the lock on file system.


Oracle Solaris 11.4               3 Nov 2021                         lockfs(8)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3