unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



tag2name(8)							  tag2name(8)



NAME

  tag2name - Display the path name of an AdvFS file

SYNOPSIS

  /sbin/advfs/tag2name tags_directory/file_tag

  /sbin/advfs/tag2name [-r] domain fileset_id file_tag

OPTIONS

  [-r]
      Specify the [-r] option to operate on the	raw device (character device
      special file) of the fileset instead of the block	device.

OPERANDS

  domain
      Specifies	the name of an AdvFS domain.

  fileset_id
      Specifies	the name of an AdvFS fileset using the following format:

      [-S] fileset | -T	fileset_tag
	  Specify the -S tag to	force the command to interpret the name	you
	  supply as a fileset name.  Specify the fileset by entering either
	  the name of the fileset, fileset, or the file's fileset tag number,
	  -T fileset_tag.

  tags_directory
      Specifies	the relative path of the AdvFS tags directory for a fileset.
      If you do	not specify this directory, the	default	is mount_point/.tags.

  file_tag
      Specifies	an AdvFS file tag number.

DESCRIPTION

  Internally, AdvFS identifies files by	tag numbers (similar to	inodes in
  UFS).	Internal messages, error messages, and output from diagnostic utili-
  ties usually specify a tag number in place of	a file name.  Use the
  tag2name command to determine	the name and path of an	AdvFS file that	is
  identified by	a tag number.

  If you enter an invalid tag number, the command returns the range of the
  valid	tags for the fileset.







  Mounted Filesets


  Each mounted AdvFS fileset has a .tags directory in its mount	point. To
  obtain a file	name, specify the path to the .tags directory for the
  fileset, followed by the tag number. The full	path name of the correspond-
  ing file is displayed	to stdout. This	syntax uses AdvFS system calls.

  Unmounted Filesets


  When you use the second form,	the utility does not use AdvFS code and	does
  not depend on	the filset being mounted.  The path name of the	file is	rela-
  tive to the fileset and is displayed on stdout.

  One use of the second	form is	to obtain names	of files from a	fileset	that
  is unmounted and might produce a domain panic	or a system panic if it	were
  mounted.

NOTES

  An active domain, which is a domain with one or more of its filesets
  mounted, has all of its volumes opened using block device special files.
  These	devices	cannot be opened a second time without first being unmounted.
  However, the character device	special	files for the volumes can be opened
  more than once while still mounted.

  It can be misleading to use the second form of this utility on a domain
  with mounted filesets.  Unlike the first form	of the utility,	the second
  form does not	synchronize its	read requests with AdvFS file domain read and
  write	requests. To avoid this	problem, unmount all the active	filesets in
  the domain before using the second form of this utility.

  For example, the AdvFS can be	writing	to the disk as the utility is reading
  from the disk.  Therefore, when you run the utility, metadata	may not	have
  been flushed in time for the utility to read it and consecutive reads	of
  the same file	page may return	unpredictable or contradictory results.	[The
  domain is not	harmed.]

RESTRICTIONS

  The second form of this utility can fail to open a block device, even	when
  there	are no filesets	mounted	for the	domain and the AdvFS daemon, advfsd
  is running. The daemon, as it	runs, activates	the domain for a brief time.
  If the tag2name utility fails	in this	situation, run it again.

  You must be the root user to use the tag2name	utility.  The tag you specify
  must be numeric and greater than 1.

EXAMPLES

   1.  The following example displays the file name corresponding to tag 5 in
       the usr fileset.	It assumes the current working directory is /usr:
	    # /sbin/advfs/tag2name .tags/5

	    /usr/quota.group

   2.  The following example displays the file name of the file	whose tag is
       145 in domain_1 fileset_1:
	    # /sbin/advfs/tag2name domain_1 fileset_1 145

	    joe/save/oldfile




FILES

  /sbin/advfs/tag2name
      Specifies	the command path.

  /etc/fdmns/domain_name
      Specifies	the volumes in the domain.

SEE ALSO

  advfs(4)