put

Uploads writable files from the workspace to the view

APPLICABILITY

SYNOPSIS

put [ -r·ecurse ] [ -compress ] [ -pti·me ] [ -to to-name ] [ -log pname ] pname...

DESCRIPTION

The put command uploads the specified writable files from the workspace to the associated view.

RESTRICTIONS

None.

OPTIONS AND ARGUMENTS

SPECIFYING THE FILES TO BE UPLOADED.  Default: None.

pname...

Specifies the files and/or directories to be uploaded. Wildcard patterns apply to the workspace contents; / (slash) denotes the root of the workspace.For example, /*.c refers to all of the .c files in the workspace root. In addition, arguments of the form @pname can be used to add the contents of the local file pname as pathname arguments. The pathname arguments can contain wildcards, and must be listed in the file one per line, or also be of the form @pname. Specifying a relative pathname for @pname begins from Attache's startup directory, not the working directory, so a full local pathname is recommended.

SPECIFYING HOW THE FILES ARE TO BE UPLOADED.  Default: When a directory is specified, its file contents are uploaded. Only writable files are uploaded, and only if the file does not exist in the view or it is different from the source file.

-to to-name

Specifies a destination file name or directory. If the specified destination is a directory, it becomes a prefix for each uploaded filename. If the specified destination is a file, or does not exist, then only one source argument can be specified, and it must be a file.

-pti·me

Applies the last-modified time stamp of the source file to the destination file. -ptime has no effect on directories.

-compress

Causes files to be compressed while being uploaded and uncompressed after the transfer to improve performance over slow communications lines. The default behavior for this option can be set with the Preferences command on the Options menu.

HANDLING OF DIRECTORY ARGUMENTS.  Default: For each pname that specifies a directory element, put uploads the contents of that directory, but not the contents of any of its subdirectories.

-r·ecurse

Includes writable files from the entire subtree below any subdirectory pname. Directories are created as necessary and specified patterns are relative to the current directory.

SPECIFYING A FILE TRANSFER LOG.  Default: None.

-log pname

Specifies a log file for the operation. The log file lists the workspace-relative pathname of each file transferred by the put command, as well as an indication of any errors that occur during the operation. Log file pathnames are absolute, not relative to the current workspace root.

Each line in a log file is a comment line, except for the names of files that were not transferred. Log files, therefore, can be used as indirect files to redo a file transfer operation.

EXAMPLES

• Upload the writable file hello.c to the view, naming it hello_new.c and preserving the time stamp. At an Attache prompt:

put -to hello_new.c -ptime hello.c

• Upload to the view all of the writable files and subdirectories beneath the directory src. At an Attache prompt:

put -r src

• Upload to the view all of the writable files listed in the file c:\users\jed\prj_files. At an Attache prompt:

put @c:\users\jed\prj_files

SEE ALSO

attache_command_line_interface, attache_graphical_interface, get, checkin, checkout, wildcards