share/man/man8/lockfs.8

   1 '\" te
   2 .\"  Copyright (c) 2008, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH LOCKFS 8 "Jan 2, 2008"
   7 .SH NAME
   8 lockfs \- change or report file system locks
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/lockfs\fR [\fB-adefhnuw\fR] [\fB-c\fR \fIstring\fR] [\fIfile-system\fR]...
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBlockfs\fR is used to change and report the status of file system locks.
  19 \fBlockfs\fR reports the lock status and unlocks the file systems that were
  20 improperly left locked.
  21 .sp
  22 .LP
  23 Using \fBlockfs\fR to lock a file system is discouraged because this requires
  24 extensive knowledge of SunOS internals to be used effectively and correctly.
  25 .sp
  26 .LP
  27 When invoked with no arguments, \fBlockfs\fR lists the \fBUFS\fR file systems
  28 that are locked. If \fIfile-system\fR is not specified, and \fB-a\fR is
  29 specified, \fBlockfs\fR is run on all mounted, \fBUFS\fR type file systems.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The options are mutually exclusive: \fBwndheuf\fR. If you do specify more than
  34 one of these options on a \fBlockfs\fR command line, the utility does not
  35 protest and invokes only the last option specified. In particular, you cannot
  36 specify a flush (\fB-f\fR) and a lock (for example, \fB-w\fR) on the same
  37 command line. However, all locking operations implicitly perform a flush, so
  38 the \fB-f\fR is superfluous when specifying a lock.
  39 .sp
  40 .LP
  41 You must be super-user to use any of the following options, with the exception
  42 of \fB-a\fR, \fB-f\fR and \fB-v\fR.
  43 .sp
  44 .LP
  45 The following options are supported.
  46 .sp
  47 .ne 2
  48 .na
  49 \fB\fB-a\fR\fR
  50 .ad
  51 .sp .6
  52 .RS 4n
  53 Apply command to all mounted, \fBUFS\fR type file systems. \fIfile-system\fR is
  54 ignored when \fB-a\fR is specified.
  55 .RE
  56
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fB-c\fR \fIstring\fR\fR
  61 .ad
  62 .sp .6
  63 .RS 4n
  64 Accept a string that is passed as the comment field. The \fB-c\fR only takes
  65 affect when the lock is being set using the \fB-d\fR, \fB-h\fR, \fB-n\fR,
  66 \fB-u\fR, or \fB-w\fR options.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-d\fR\fR
  73 .ad
  74 .sp .6
  75 .RS 4n
  76 Delete-lock (\fBdlock\fR) the specified \fIfile-system\fR. dlock suspends
  77 access that could remove directory entries.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-e\fR\fR
  84 .ad
  85 .sp .6
  86 .RS 4n
  87 Error-lock (\fBelock\fR) the specified \fIfile-system\fR. elock blocks all
  88 local access to the locked file system and returns \fBEWOULDBLOCK\fR on all
  89 remote access. File systems are elocked by \fBUFS\fR on detection of internal
  90 inconsistency. They may only be unlocked after successful repair by \fBfsck\fR,
  91 which is usually done automatically (see \fBmount_ufs\fR(8)). elocked file
  92 systems can be unmounted.
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-f\fR\fR
  99 .ad
 100 .sp .6
 101 .RS 4n
 102 Force a synchronous flush of all data that is dirty at the time \fBfsflush\fR
 103 is run to its backing store for the named file system (or for all file
 104 systems.)
 105 .sp
 106 It is a more reliable method than using \fBsync\fR(8) because it does not
 107 return until all possible data has been pushed. In the case of \fBUFS\fR
 108 filesystems with logging enabled, the log is also rolled before returning.
 109 Additional data can be modified by the time \fBfsflush\fR exits, so using one
 110 of the locking options is more likely to be of general use.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB-h\fR\fR
 117 .ad
 118 .sp .6
 119 .RS 4n
 120 Hard-lock (\fBhlock\fR) the specified \fIfile-system\fR. hlock returns an error
 121 on every access to the locked file system, and cannot be unlocked. hlocked file
 122 systems can be unmounted.
 123 .RE
 124
 125 .sp
 126 .ne 2
 127 .na
 128 \fB\fB-n\fR\fR
 129 .ad
 130 .sp .6
 131 .RS 4n
 132 Name-lock (\fBnlock\fR) the specified \fIfile-system\fR. nlock suspends
 133 accesses that could change or remove existing directories entries.
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB-u\fR\fR
 140 .ad
 141 .sp .6
 142 .RS 4n
 143 Unlock (\fBulock\fR) the specified \fIfile-system\fR. ulock awakens suspended
 144 accesses.
 145 .RE
 146
 147 .sp
 148 .ne 2
 149 .na
 150 \fB\fB-v\fR\fR
 151 .ad
 152 .sp .6
 153 .RS 4n
 154 Enable verbose output.
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fB\fB-w\fR\fR
 161 .ad
 162 .sp .6
 163 .RS 4n
 164 Write-lock (\fBwlock\fR) the specified \fIfile-system\fR. wlock suspends writes
 165 that would modify the file system. Access times are not kept while a file
 166 system is write-locked.
 167 .RE
 168
 169 .SH OPERANDS
 170 .sp
 171 .LP
 172 The following operands are supported.
 173 .sp
 174 .ne 2
 175 .na
 176 \fB\fIfile-system\fR\fR
 177 .ad
 178 .sp .6
 179 .RS 4n
 180 A list of path names separated by whitespace. Note that \fIfile-system\fR can
 181 be a directory rather than the specific name of a file system, such as \fB/\fR
 182 or \fB/usr\fR. For example, if you specify \fB/export/home\fR as an argument to
 183 a \fBlockfs\fR command and \fB/export/home\fR is mounted on the root (\fB/\fR)
 184 file system, the \fBlockfs\fR command will take effect on the root file system.
 185 .RE
 186
 187 .SH EXAMPLES
 188 .LP
 189 \fBExample 1 \fRUsing \fBlockfs\fR \fB-a\fR
 190 .sp
 191 .LP
 192 In the following examples, \fIfilesystem\fR is the pathname of the mounted-on
 193 directory (mount point). \fBLocktype\fR is one of "\fBwrite\fR," "\fIname\fR,"
 194 "\fIdelete\fR," "\fIhard\fR," or "\fIunlock\fR". When enclosed in parenthesis,
 195 the lock is being set. \fBComment\fR is a string set by the process that last
 196 issued a lock command.
 197
 198 .sp
 199 .LP
 200 The following example shows the \fBlockfs\fR output when only the \fB-a\fR
 201 option is specified.
 202
 203 .sp
 204 .in +2
 205 .nf
 206 example#  \fB/usr/sbin/lockfs -a\fR
 207 .fi
 208 .in -2
 209 .sp
 210
 211 .sp
 212
 213 .sp
 214 .TS
 215 l l l
 216 l l l .
 217 Filesystem      Locktype         Comment
 218 /       unlock
 219 /var    unlock
 220 .TE
 221
 222 .sp
 223 .in +2
 224 .nf
 225 example#
 226 .fi
 227 .in -2
 228 .sp
 229
 230 .LP
 231 \fBExample 2 \fRUsing \fBlockfs\fR \fB-w\fR
 232 .sp
 233 .LP
 234 The following example shows the \fBlockfs\fR output when the \fB-w\fR option is
 235 used to write lock the \fB/var\fR file system and the comment string is set
 236 using the \fB-c\fR option.  The \fB-a\fR option is then specified on a separate
 237 command line.
 238
 239 .sp
 240 .in +2
 241 .nf
 242 example#  \fB/usr/sbin/lockfs -w -c "lockfs: write lock example" /var\fR
 243 example#  \fB/usr/sbin/lockfs -a\fR
 244 .fi
 245 .in -2
 246 .sp
 247
 248 .sp
 249
 250 .sp
 251 .TS
 252 l l l
 253 l l l .
 254 Filesystem      Locktype        Comment
 255 /       unlock
 256 /var    write   lockfs: write lock example
 257 .TE
 258
 259 .sp
 260 .in +2
 261 .nf
 262 example#
 263 .fi
 264 .in -2
 265 .sp
 266
 267 .LP
 268 \fBExample 3 \fRUsing \fBlockfs\fR \fB-u\fR
 269 .sp
 270 .LP
 271 The following example shows the \fBlockfs\fR output when the \fB-u\fR option is
 272 used to unlock the \fB/var\fR file system and the comment string is set using
 273 the \fB-c\fR option.
 274
 275 .sp
 276 .in +2
 277 .nf
 278 example#  \fB/usr/sbin/lockfs -uc "lockfs: unlock example" /var\fR
 279 example#  \fB/usr/sbin/lockfs /var\fR
 280 .fi
 281 .in -2
 282 .sp
 283
 284 .sp
 285
 286 .sp
 287 .TS
 288 l l l
 289 l l l .
 290 Filesystem      Locktype        Comment
 291 /var    unlock  lockfs: unlock example
 292 .TE
 293
 294 .sp
 295 .in +2
 296 .nf
 297 example#
 298 .fi
 299 .in -2
 300 .sp
 301
 302 .SH SEE ALSO
 303 .sp
 304 .LP
 305 \fBkill\fR(1), \fBmount_ufs\fR(8), \fBsync\fR(8), \fBattributes\fR(5),
 306 \fBufs\fR(7FS),
 307 .sp
 308 .LP
 309 \fI\fR
 310 .SH DIAGNOSTICS
 311 .sp
 312 .ne 2
 313 .na
 314 \fB\fIfile system\fR\fB: Not owner\fR\fR
 315 .ad
 316 .sp .6
 317 .RS 4n
 318 You must be root to use this command.
 319 .RE
 320
 321 .sp
 322 .ne 2
 323 .na
 324 \fB\fIfile system\fR \fB:Deadlock condition detected/avoided\fR\fR
 325 .ad
 326 .sp .6
 327 .RS 4n
 328 A file is enabled for accounting or swapping, on \fIfile system\fR.
 329 .RE
 330
 331 .sp
 332 .ne 2
 333 .na
 334 \fB\fIfile system\fR\fB: Device busy\fR\fR
 335 .ad
 336 .sp .6
 337 .RS 4n
 338 Another process is setting the lock on \fIfile system\fR.
 339 .RE
 340