CDE/cde/doc/C/guides/man/man1/ttmv.sgm

<!-- $XConsortium: ttmv.sgm /main/6 1996/08/30 15:42:23 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCDI.MAN3.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCDI.MAN3.rsml.1">]]>
<RefMeta>
<RefEntryTitle>ttmv</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>ttmv</Command></RefName>
<RefPurpose>move or rename files and inform the ToolTalk service
</RefPurpose>
</RefNameDiv>
<!-- $XConsortium: ttmv.sgm /main/6 1996/08/30 15:42:23 rws $-->
<!-- CDE Common Source Format, Version 1.0.0-->
<!-- (c) Copyright 1993, 1994, 1995 Hewlett-Packard Company-->
<!-- (c) Copyright 1993, 1994, 1995 International Business Machines Corp.-->
<!-- (c) Copyright 1993, 1994, 1995 Sun Microsystems, Inc.-->
<!-- (c) Copyright 1993, 1994, 1995 Novell, Inc.-->
<RefSynopsisDiv>
<CmdSynopsis>
<Command>ttmv</Command>
<Arg Choice="opt">&minus;fL</Arg>
<Arg><Replaceable>pathname1</Replaceable></Arg>
<Arg><Replaceable>pathname2</Replaceable></Arg>
<!-- -->
</CmdSynopsis>
<CmdSynopsis>
<Command>ttmv</Command>
<Arg Choice="opt">&minus;fL</Arg>
<Arg><Replaceable>pathname</Replaceable></Arg>
<Arg>.&thinsp;.&thinsp;.</Arg>
<Arg><Replaceable>directory</Replaceable></Arg>
<!-- -->
</CmdSynopsis>
<CmdSynopsis>
<Command>ttmv</Command>
<Arg>&minus;h</Arg>
<Arg>&minus;v</Arg>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Command>ttmv</Command> utility
invokes
<Command>mv</Command>(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.
</Para>
<Para>The
<Command>ttmv</Command> 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.
</Para>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<![ %CDE.C.XO; [
<Para>The
<Command>ttmv</Command> utility supports the &str-Zu;.
</Para>
]]>
<Para>The following options are available:
</Para>
<VariableList>
<VarListEntry>
<Term><Literal>&minus;f</Literal></Term>
<ListItem>
<Para>Force.
Do not report any errors, and pass the
<Literal>&minus;f</Literal> option to
<Command>mv</Command>(1).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;h</Literal></Term>
<ListItem>
<Para>Write a help message for invoking
<Command>ttmv</Command> and then exit.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;L</Literal></Term>
<ListItem>
<Para>Move the ToolTalk objects of the files, but do not invoke
<Command>mv</Command>(1) to move the actual files.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>&minus;v</Literal></Term>
<ListItem>
<Para>Write the version number of
<Command>ttmv</Command> and then exit.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><![ %CDE.C.XO; [It is unspecified whether the
<Literal>&minus;i</Literal> option to
<Command>mv</Command>(1) is supported.
]]><![ %CDE.C.CDE; [The
<Literal>&minus;i</Literal> option to
<Command>cp</Command>(1) is not supported.
]]></Para>
</RefSect1>
<RefSect1>
<Title>OPERANDS</Title>
<Para>The following operands are supported:
</Para>
<VariableList>
<VarListEntry>
<Term><Emphasis>pathname1</Emphasis></Term>
<ListItem>
<Para>A pathname of a file to be moved.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>pathname2</Emphasis></Term>
<ListItem>
<Para>A pathname of an existing or nonexisting file,
used for the output when a single file is moved.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>directory</Emphasis></Term>
<ListItem>
<Para>A pathname of a directory to contain the moved files.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>STDIN</Title>
<Para>Not used.
</Para>
</RefSect1>
<RefSect1>
<Title>INPUT FILES</Title>
<Para>The input files specified as operands can be of any file type.
</Para>
</RefSect1>
<RefSect1>
<Title>ENVIRONMENT VARIABLES</Title>
<Para>The following environment variables affect the execution of
<Command>ttmv</Command>:</Para>
<VariableList>
<VarListEntry>
<Term><SystemItem Class="EnvironVar">LANG</SystemItem></Term>
<ListItem>
<Para>Provide a default value for the internationalization variables
that are unset or null.
If
<SystemItem Class="EnvironVar">LANG</SystemItem> is unset or null, the corresponding value from the
implementation-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.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>LC_ALL</Emphasis></Term>
<ListItem>
<Para>If set to a non-empty string value,
override the values of all the other internationalization variables.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>LC_MESSAGES</Emphasis></Term>
<ListItem>
<Para>Determine the locale that is used to affect
the format and contents of diagnostic
messages written to standard error
and informative messages written to standard output.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><SystemItem Class="EnvironVar">NLSPATH</SystemItem></Term>
<ListItem>
<Para>Determine the location of message catalogues
for the processing of
<Emphasis>LC_MESSAGES</Emphasis>.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>RESOURCES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>ASYNCHRONOUS EVENTS</Title>
<![ %CDE.C.XO; [
<Para>Default.
</Para>
]]>
<![ %CDE.C.CDE; [
<Para>The
<Command>ttmv</Command> utility takes the standard action for all signals.
</Para>
]]>
</RefSect1>
<RefSect1>
<Title>STDOUT</Title>
<Para>When the
<Literal>&minus;h</Literal> option is used,
<Command>ttmv</Command> writes to standard output a help message
in an unspecified format.
</Para>
<Para>When the
<Literal>&minus;v</Literal> option is used,
<Command>ttmv</Command> writes to standard output a version number
in an unspecified format.
</Para>
</RefSect1>
<RefSect1>
<Title>STDERR</Title>
<Para>Used only for diagnostic messages.
</Para>
</RefSect1>
<RefSect1>
<Title>OUTPUT FILES</Title>
<Para>The output files can be of any type.
</Para>
</RefSect1>
<RefSect1>
<Title>EXTENDED DESCRIPTION</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXIT STATUS</Title>
<Para>The following exit values are returned:
</Para>
<VariableList>
<VarListEntry>
<Term>0</Term>
<ListItem>
<Para>All files and ToolTalk objects were moved successfully.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>>0</Term>
<ListItem>
<Para>An error occurred or the invoked
<Command>mv</Command>(1) command exited with a non-zero value.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1>
<Title>CONSEQUENCES OF ERRORS</Title>
<Para>Default.
</Para>
</RefSect1>
<![ %CDE.C.CDE; [<RefSect1>
<Title>FILES</Title>
<VariableList>
<VarListEntry>
<Term>/mountpoint/TT_DB</Term>
<ListItem>
<!-- ex-TP-->
<Para>The directory used as a database
for the ToolTalk objects of files in the
file system mounted at
<Emphasis>/mountpoint</Emphasis>.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</RefSect1>]]>
<RefSect1>
<Title>APPLICATION USAGE</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXAMPLES</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para><![ %CDE.C.CDE; [<Command>mv</Command>(1)]]><![ %CDE.C.XO; [<Command>mv</Command> in the &str-ZC;]]>,
&cdeman.ttsession;.</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->