ttmv - move or rename files and inform the ToolTalk service
ttmv [-fL] pathname1 pathname2 ttmv [-fL] pathname ... directory ttmv -h | -v
ttmv(1) ToolTalk Commands ttmv(1)
NAME
ttmv - move or rename files and inform the ToolTalk service
SYNOPSIS
ttmv [-fL] pathname1 pathname2
ttmv [-fL] pathname ... directory
ttmv -h | -v
DESCRIPTION
The ttmv utility invokes mv(1) to move files and directories around in
the file system and informs ToolTalk about its actions so that the
ToolTalk objects associated with those files and directories can also
be moved.
The ttmv utility moves the ToolTalk objects before it moves the files
and does not check whether the file-moving operation will succeed
before performing the object-moving operation.
OPTIONS
The following options are available:
-f Force. Do not report any errors, and pass the -f option to
mv(1).
-h Write a help message for invoking ttmv and then exit.
-L Move the ToolTalk objects of the files, but do not invoke
mv(1) to move the actual files.
-v Write the version number of ttmv and then exit.
The -i option to cp(1) is not supported.
OPERANDS
The following operands are supported:
pathname1
A pathname of a file to be moved.
pathname2
A pathname of an existing or nonexisting file, used for the
output when a single file is moved.
directory
A pathname of a directory to contain the moved files.
STDIN
Not used.
INPUT FILES
The input files specified as operands can be of any file type.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of ttmv:
LANG Provide a default value for the internationalization
variables that are unset or null. If LANG is unset
or null, the corresponding value from the implementa-
tion-specific default locale will be used. If any of
the internationalization variables contains an
invalid setting, the utility behaves as if none of
the variables had been defined.
LC_ALL If set to a non-empty string value, override the val-
ues of all the other internationalization variables.
LC_MESSAGES Determine the locale that is used to affect the for-
mat and contents of diagnostic messages written to
standard error and informative messages written to
standard output.
NLSPATH Determine the location of message catalogues for the
processing of LC_MESSAGES.
RESOURCES
None.
ASYNCHRONOUS EVENTS
The ttmv utility takes the standard action for all signals.
STDOUT
When the -h option is used, ttmv writes to standard output a help mes-
sage in an unspecified format.
When the -v option is used, ttmv writes to standard output a version
number in an unspecified format.
STDERR
Used only for diagnostic messages.
OUTPUT FILES
The output files can be of any type.
EXTENDED DESCRIPTION
None.
EXIT STATUS
The following exit values are returned:
0 All files and ToolTalk objects were moved successfully.
>0 An error occurred or the invoked mv(1) command exited with a
non-zero value.
CONSEQUENCES OF ERRORS
Default.
FILES
/mountpoint/TT_DB The directory used as a database for the ToolTalk
objects of files in the file system mounted at
/mountpoint.
APPLICATION USAGE
None.
EXAMPLES
None.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
mv(1), ttsession(1).
ToolTalk 1.3 1 March 1996 ttmv(1)