share/man/man8/clear_locks.8

   1 '\" te
   2 .\"  Copyright (c) 1996, Sun Microsystems, Inc.
   3 .\"  All Rights Reserved
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH CLEAR_LOCKS 8 "Oct 6, 2004"
   8 .SH NAME
   9 clear_locks \- clear locks held on behalf of an NFS client
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/sbin/clear_locks\fR [\fB-s\fR] \fIhostname\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBclear_locks\fR command removes all file, record, and share locks created
  20 by the \fIhostname\fR and held on the current host, regardless of which process
  21 created or owns the locks.
  22 .sp
  23 .LP
  24 This command can be run only by the super-user.
  25 .sp
  26 .LP
  27 This command should only be used to repair the rare case of a client crashing
  28 and failing to clear held locks. Clearing locks held by an active client may
  29 cause applications to fail in an unexpected manner.
  30 .SH OPTIONS
  31 .sp
  32 .ne 2
  33 .na
  34 \fB\fB-s\fR\fR
  35 .ad
  36 .RS 6n
  37 Remove all locks created by the current machine and held by the server
  38 \fIhostname\fR.
  39 .RE
  40
  41 .SH OPERANDS
  42 .sp
  43 .LP
  44 The following operands are supported:
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fIhostname\fR\fR
  49 .ad
  50 .RS 12n
  51 name of host server
  52 .RE
  53
  54 .SH EXIT STATUS
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB0\fR\fR
  59 .ad
  60 .RS 5n
  61 Successful operation.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB1\fR\fR
  68 .ad
  69 .RS 5n
  70 If not root.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB2\fR\fR
  77 .ad
  78 .RS 5n
  79 Usage error.
  80 .RE
  81
  82 .sp
  83 .ne 2
  84 .na
  85 \fB\fB3\fR\fR
  86 .ad
  87 .RS 5n
  88 If unable to contact server (\fBRPC\fR).
  89 .RE
  90
  91 .SH SEE ALSO
  92 .sp
  93 .LP
  94 \fBfcntl\fR(2), \fBattributes\fR(5)