share/man/man8/ncheck.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 2001, 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 NCHECK 8 "May 30, 2001"
   7 .SH NAME
   8 ncheck \- generate a list of path names versus i-numbers
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBncheck\fR [\fB-F\fR \fIFSType\fR] [\fB-V\fR] [\fIgeneric_options\fR]
  13      [\fB-o\fR \fIFSType-specific_options\fR] [\fIspecial\fR]...
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBncheck\fR with no options generates a path-name versus i-number list of all
  20 files on  \fIspecial\fR. If  \fIspecial\fR is not specified on the command line
  21 the list is generated for all \fIspecial\fRs in  \fB/etc/vfstab\fR which have a
  22 numeric  \fBfsckpass\fR. \fIspecial\fR is the raw device on which the file
  23 system exists.
  24 .SH OPTIONS
  25 .sp
  26 .ne 2
  27 .na
  28 \fB\fB-F\fR\fR
  29 .ad
  30 .RS 19n
  31 Specify the  \fIFSType\fR on which to operate. The  \fIFSType\fR should either
  32 be specified here  or be determinable from \fB/etc/vfstab\fR by finding an
  33 entry in the table that has a numeric  \fBfsckpass\fR field and an
  34 \fBfsckdev\fR that matches \fIspecial\fR.
  35 .RE
  36
  37 .sp
  38 .ne 2
  39 .na
  40 \fB\fB-V\fR\fR
  41 .ad
  42 .RS 19n
  43 Echo the complete command line, but do not execute the command. The command
  44 line is generated by using the options and arguments provided by the user and
  45 adding to them information derived from  \fB/etc/vfstab\fR. This option may be
  46 used to verify and validate the command line.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fIgeneric_options\fR\fR
  53 .ad
  54 .RS 19n
  55 Options that are commonly supported by most FSType-specific command modules.
  56 The following options are available:
  57 .sp
  58 .ne 2
  59 .na
  60 \fB\fB-i\fR\fI i-list\fR\fR
  61 .ad
  62 .RS 13n
  63 Limit the report to the files on the  \fIi-list\fR that follows. The
  64 \fIi-list\fR must be separated by commas with no intervening spaces.
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fB-a\fR\fR
  71 .ad
  72 .RS 13n
  73 Print the names "." and ".\|." which are ordinarily suppressed.
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fB-s\fR\fR
  80 .ad
  81 .RS 13n
  82 Report only special files and files with set-user-ID mode. This option may be
  83 used to detect violations of security policy.
  84 .RE
  85
  86 .RE
  87
  88 .sp
  89 .ne 2
  90 .na
  91 \fB\fB-o\fR\fR
  92 .ad
  93 .RS 19n
  94 Specify  \fIFSType-specific_options\fR in a comma separated (without spaces)
  95 list of suboptions and keyword-attribute pairs for interpretation by the
  96 FSType-specific module of the command.
  97 .RE
  98
  99 .SH USAGE
 100 .sp
 101 .LP
 102 See \fBlargefile\fR(5) for the description of the behavior of \fBncheck\fR when
 103 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 104 .SH FILES
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fB/etc/vfstab\fR\fR
 109 .ad
 110 .RS 15n
 111 list of default parameters for each file system
 112 .RE
 113
 114 .SH SEE ALSO
 115 .sp
 116 .LP
 117 \fBvfstab\fR(4), \fBattributes\fR(5), \fBlargefile\fR(5) Manual pages for the
 118 FSType-specific modules of  \fBncheck\fR
 119 .SH NOTES
 120 .sp
 121 .LP
 122 This command may not be supported for all  \fIFSTypes\fR.