unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



ncheck(8)							    ncheck(8)



NAME

  ncheck - lists i-number or tag and path name for files in a local file sys-
  tem.

SYNOPSIS

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

OPTIONS

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

  -i numbers
      Lists only those files with the specified	i-numbers (UFS)	or tags
      (AdvFS).	If you enter a zero (0)	all allocated numbers will be
      displayed.

  -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 on the com-
      mand 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	spe-
	   cial	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 correspond-
  ing 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 inap-
  propriate 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

  sort(1), quot(8)