test

TotalNET Advanced Server 5.2 Reference Manual

tnvolck

This command checks and synchronizes files and directories under TAS volumes for the integrity of their corresponding TAS shadow files. The filename-case attribute of the volume specifies the volume's naming convention. The command only needs to synchronize file names 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.

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

This command checks for TAS shadow files that have different owner, group and mode information from their corresponding UNIX base files. This condition may occur if a user has changed the ownership and mode of the UNIX files 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 files' UNIX names follow their TAS volumes' naming conventions. If a file's name does not follow its volume's specified convention, tnvolck attempts to synchronize it.

Location

TNHOME/usr/bin

Usage

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

Options

-a 

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

-y 

Assume a yes response to all questions asked by tnvolck without prompting for confirmation. Use this option when you want tnvolck to synchronize shadow files.

-n 

Assume a no response to all questions asked by tnvolck without prompting for confirmation. If tnvolck finds inconsistencies, it prints error messages. Use this option when you want tnvolck to check the volume without actually synchronizing shadow files.

-p 

Suppress file name conversion. If you specify this option, tnvolck preserves file names without prompting for confirmation. Before modifying a file name or deleting a shadow file, tnvolck prompts for confirmation.

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. For information on TAS-supported escape sequences for path substitution, refer to the "tnvolume" command. The directory paths defined in this file substitute the volume's path attribute. If tnvolck finds a volume with a substitutable path, but you specify no file, tnvolck prints a warning and skips that volume.

Examples

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


    tnvolck myvol

  2. Use the following command 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:


    tnvolck mybin:/tmp/mydoc.txt

    The /tmp/mydoc.txt path, an ASCII file, contains a list of directory names. Each line should contain a directory path name. For example, the file might contain the following entries:


    /home/simon
/home/steven
/home/emily

  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 the volume singular without performing directory synchronization or clean-up:


    tnvolck -n singular

  6. Use the following command to check and clean up the volume spartacus without converting file names:


    tnvolck -p spartacus