Index Index for
Section 8
Index Alphabetical
listing for N
Bottom of page Bottom of
page		 

ncheck(8)


NAME

  ncheck - Lists i-number or tag and pathname for files in a local file
  system.


SYNOPSIS

  /usr/sbin/ncheck [-i numbers] [-asm] [device_special_file |
  advfs_domain]...


OPTIONS

  -a  Includes in the list the pathnames . (dot) and .. (dot dot), which are
      ordinarily suppressed.

  -i numbers
      Lists only those existing files with the specified i-numbers (UFS) or
      tags (AdvFS).

  -m  Includes in the list the mode, UID, and GID of the files.	 To use this
      option you must also specify either the -i or the -s option from the
      command line.

  -s  Lists only the special files and files with set-user-ID mode.


OPERANDS

  device_special_file | advfs_domain
      Specifies one or more file systems.  Specify a file system by entering
      its device special file name or AdvFS domain as shown in the /etc/fstab
      file as follows:

	·  Specify a UFS file system by entering the name of its device
	   special file.  For example: /dev/disk/dsk3c. You can also specify
	   the raw device, such as /dev/rdisk/dsk4a.  You cannot specify the
	   UFS mount point, such as /usr or the following message is
	   displayed:
		ncheck: cannot open /usr: Device busy

	·  Specify an AdvFS fileset by entering the name of the file domain,
	   a pound sign (#) character, and the name of the fileset.  For
	   example: root_domain#root.


DESCRIPTION

  The ncheck command with no options generates a list of all files on every
  specified file system.  The list includes the path name and the
  corresponding i-number or tag of each file. Each directory file name in the
  list is followed by a /. (slash dot). Use the available options to
  customize the list to include or exclude specific types of files.

  The files are listed in order by i-number or tag. To sort the list in a
  more useful format, pipe the output to the sort command.


NOTES

  To uncover concealed violations of security policy, that is, the
  inappropriate use of the set-user-ID mode, issue the command with the -s
  option to list only special files and files with set-user-ID mode.


RESTRICTIONS

  You must be the root user to use this command.

  The ncheck command checks the /etc/fstab file for the specified domain and
  file system entry. If there is no entry in /etc/fstab for the specified
  file system, an error message is displayed to	 indicate that the file does
  not exist.


ERRORS

  cannot ncheck ""nnn"" file system
      The ncheck command can be used only for checking local file systems.
      The "nnn" string identifies the file system type.

  cannot ncheck "advfs" filesystem
      Specify the AdvFS domain instead of the file system path (such as
      /var).


DIAGNOSTICS

  When the file system structure is improper, ?? (question mark question
  mark) denotes the parent of a parentless file.  A path name beginning with
  ... (dot dot dot) denotes a loop.


EXAMPLES

  The following example shows command options taking data from a sample
  /etc/fstab file:

       # more /etc/fstab
       /dev/disk/dsk4a /       ufs rw 1 1
       /proc	       /proc   procfs rw 0 0
       usr_domain#usr  /usr    advfs rw 0 2
       var_domain#var  /var    advfs rw 0 2
       # /usr/sbin/ncheck /usr
       cannot ncheck "advfs" filesystem
       # /usr/sbin/ncheck usr_domain#usr

       usr_domain#usr:
       3       /.tags/.
       4       /quota.user
       5       /quota.group
       .
       .
       .
       # /usr/sbin/ncheck /dev/disk/dsk4a
       /dev/rdisk/dsk4a (/dev/disk/dsk4a):
       3200    /cluster/.
       12801   /etc/.
       .
       .
       .
       # /usr/sbin/ncheck /
       ncheck: cannot open /: Device busy


FILES

  /usr/sbin/ncheck
      Specifies the command path.


SEE ALSO

  Commands: sort(1), quot(8)

Index Index for
Section 8
Index Alphabetical
listing for N
Top of page Top of
page