<!-- $XConsortium: ttcp.sgm /main/7 1996/08/30 15:42:00 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.MAN2.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCDI.MAN2.rsml.1">]]>
<RefMeta>
<RefEntryTitle>ttcp</RefEntryTitle>
<ManVolNum>user cmd</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Command>ttcp</Command></RefName>
<RefPurpose>copy files and inform the ToolTalk service
</RefPurpose>
</RefNameDiv>
<!-- $XConsortium: ttcp.sgm /main/7 1996/08/30 15:42:00 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>ttcp</Command>
<Arg Choice="opt">-pL</Arg>
<Arg><Replaceable>filename1</Replaceable></Arg>
<Arg><Replaceable>filename2</Replaceable></Arg>
<!-- -->
</CmdSynopsis>
<CmdSynopsis>
<Command>ttcp</Command>
<Arg>-r</Arg>
<Arg Choice="opt">-pL</Arg>
<Arg><Replaceable>directory1</Replaceable></Arg>
<Arg><Replaceable>directory2</Replaceable></Arg>
<!-- -->
</CmdSynopsis>
<CmdSynopsis>
<Command>ttcp</Command>
<Arg Choice="opt">-prL</Arg>
<Arg><Replaceable>filename</Replaceable></Arg>
<Arg>...</Arg>
<Arg><Replaceable>directory</Replaceable></Arg>
<!-- -->
</CmdSynopsis>
<CmdSynopsis>
<Command>ttcp</Command>
<Arg>-h</Arg>
<Arg>-v</Arg>
</CmdSynopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Command>ttcp</Command> utility
invokes the
<Command>cp</Command>(1) utility to copy files and directories, and informs ToolTalk about its
actions so that the ToolTalk objects associated with those files
and directories can also be copied.
</Para>
</RefSect1>
<RefSect1>
<Title>OPTIONS</Title>
<![ %CDE.C.XO; [
<Para>The
<Command>ttcp</Command> utility supports the &str-Zu;.
</Para>
]]>
<Para>The following options are available:
</Para>
<VariableList>
<VarListEntry>
<Term><Literal>-h</Literal></Term>
<ListItem>
<Para>Write a help message for invoking
<Command>ttcp</Command> and then exit.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-L</Literal></Term>
<ListItem>
<Para>Copy the ToolTalk objects of the files, but do not invoke
<Command>cp</Command>(1) to copy the actual files.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-p</Literal></Term>
<ListItem>
<Para>Preserve.
Invoke
<Command>cp</Command>(1) with the
<Literal>-p</Literal> option, which
duplicates not only the contents of the original files
or directories, but also the modification time and permission modes.
The modification times of ToolTalk objects are preserved only if
the invoking process has appropriate privileges.
<![ %CDE.C.CDE; [(Super-user permissions are required.)
]]></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-r</Literal></Term>
<ListItem>
<Para>Recursively copy the ToolTalk objects of any directories named,
along with their files (including any
subdirectories and their files), and pass the
<Literal>-r</Literal> option to
<Command>cp</Command>(1).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Literal>-v</Literal></Term>
<ListItem>
<Para>Write the version number of
<Command>ttcp</Command> and then exit.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><![ %CDE.C.XO; [It is unspecified whether the
<Literal>-f</Literal>, <Literal>-i</Literal> or
<Literal>-R</Literal> options to
<Command>cp</Command>(1) are supported.
]]><![ %CDE.C.CDE; [The
<Literal>-f</Literal>, <Literal>-i</Literal> or
<Literal>-R</Literal> options to
<Command>cp</Command>(1) are not supported.
]]></Para>
</RefSect1>
<RefSect1>
<Title>OPERANDS</Title>
<Para>The following operands are supported:
</Para>
<VariableList>
<VarListEntry>
<Term><Symbol Role="Variable">filename</Symbol></Term>
<ListItem>
<Para></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>filename1</Emphasis></Term>
<ListItem>
<Para>A pathname of a file to be copied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>filename2</Emphasis></Term>
<ListItem>
<Para>A pathname of an existing or nonexisting file,
used for the output when a single file is copied.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>directory</Emphasis></Term>
<ListItem>
<Para></Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>directory2</Emphasis></Term>
<ListItem>
<Para>A pathname of a directory to contain the copied files.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term><Emphasis>directory1</Emphasis></Term>
<ListItem>
<Para>A pathname of a file hierarchy to be copied with
<Literal>-r</Literal>.</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>ttcp</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>ttcp</Command> utility takes the standard action for all signals.
</Para>
]]>
</RefSect1>
<RefSect1>
<Title>STDOUT</Title>
<Para>When the
<Literal>-h</Literal> option is used,
<Command>ttcp</Command> writes to standard output a help message
in an unspecified format.
</Para>
<Para>When the
<Literal>-v</Literal> option is used,
<Command>ttcp</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 copied successfully.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>>0</Term>
<ListItem>
<Para>An error occurred or the invoked
<Command>cp</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>cp</Command>(1)]]><![ %CDE.C.XO; [<Command>cp</Command> in the &str-ZC;]]>,
&cdeman.ttmv;, &cdeman.tttar;, &cdeman.ttsession;.</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->
