test

TotalNET Advanced Server 5.2 Release Notes

tnvolck

Description

The tnvolck command checks files and directories under a TAS volume for the integrity of their corresponding TAS shadow files.

The filename-case attribute of a volume determines its naming convention. You need to synchronize file names only for volumes with the filename-case attribute set to lower. By default, if tnvolck needs to synchronize a file name, it prompts for user confirmation before converting the file name.

The tnvolck command checks for TAS shadow files that no longer have their corresponding UNIX base files. This condition may occur if users have moved or removed the UNIX file using UNIX commands such as mv or rm, instead of TAS commands tnmv or tnrm. The tnvolck command removes these shadow files.

The tnvolck command checks for TAS shadow files that have different owner, group and mode information than their corresponding UNIX base files. This condition may occur if users have changed the ownership and mode of the UNIX file using UNIX commands such as chown, chgrp or chmod instead of TAS commands tnchown, tnchgrp or tnchmod. The tnvolck command changes the information on the shadow files to match the information of their corresponding UNIX files.

The tnvolck command checks to see if the file's UNIX name complies with naming conventions for the TAS volume in which the file resides. If the name does not comply with the specified convention, tnvolck attempts to synchronize it.

If you specify the -p option, tnvolck preserves file name case without prompting for confirmation. Before modifying a file name or deleting a shadow file, tnvolck prompts for user confirmation.

If you specify the -y option, tnvolck behaves as if you answer yes (y) to all questions. It does not prompt for confirmation. Use this option only when you want tnvolck to synchronize shadow files.

If you specify the -n option, tnvolck behaves as if you answer no (n) to all questions. It does not prompt for confirmation. If it finds inconsistencies, tnvolck prints error messages. Use this option only when you want tnvolck to check the volume without synchronizing shadow files.

Usage


# tnvolck [-a] [-y|-n] [-p] [volume[:file]]

Options

-a

Run tnvolck on all TAS volumes except those with substitutable paths.

-y

Assume a yes response to all questions asked by tnvolck.

-n

Assume a no response to all questions asked by tnvolck.

-p

Suppress file name conversion. 

volume

Specify a volume. 

file

Specify a file name that contains a list of valid directory paths. Use this only if the volume has a substitutable path for its path attribute. The directory paths defined in this file substitute the volume's path attribute. If tnvolck finds a volume with substitutable path, but you specified no file, tnvolck prints a warning and skips that volume. For information on TAS-supported escape sequences for path substitution, refer to the tnvolume command description in the TAS Reference Manual, which you can access by clicking Documentation in the TotalAdmin menu frame of TNAS.

Examples

  1. Use the following command to check and clean up shadow files in the volume myvol:


    # tnvolck myvol

  2. Use the command below to check and clean up shadow files in the volume mybin, which has a substitutable path, and replace it with the path contained in the file /tmp/mydoc.txt, an ASCII file containing a list of directory names. Each line should in /tmp/mydoc.txt should contain a directory path name. For example, the file might contain the following entries:/home/simon, /home/steven, and /home/emily.


    # tnvolck mybin:/tmp/mydoc.txt

  3. Use the following command to check and clean up all TAS volumes, as found in the TAS configuration file:


    # tnvolck -a

  4. Use the following command to check and clean up the volume saleorders and assume a yes answer to all questions:


    # tnvolck -y saleorders

  5. Use the following command to check, but not perform directory synchronization or clean-up on, the volume singular:


    # tnvolck -n singular

  6. Use the following command to check and clean up the volume spartacus and suppress the file name conversion:


    # tnvolck -p spartacus