get

Get files when you want to view a file but do not need to make any changes. A read-only copy of files or a repository is retrieved to a local directory.

Option	Description
Item	Files or repository to get. Enter / to use repository in -p or the default working directory repository. Use quotes in Unix if Item includes wildcard characters.
-a	StateID to search for. Only latest file version in this state is retrieved. Use lsstate to find StateID. Cannot use with -l, -s, or -v.
-b	Branch that contains files or repository. If not specified, default working directory branch is used.
-d	Local directory to get files to. If Item is a repository, a subdirectory with the same name is created and files are copied to it. If Item is /, files are copied to current local directory. If Item is not specified, files are copied to working directory.
-e	Make local files writable.
-f	Force file retrieval from server.
-g	Override the client's default text file end-of-line format option: Windows, Unix, Mac, WindowsAppend, UnixAppend, or MacAppend.
-h	Display online help for the command.
-i	Include removed files when getting files by label or timestamp. Enter -i- if you do not want to include removed files.
-j	Display the file version retrieved.
-l	Label to search for. Only files with this label are retrieved. Cannot use with -a, -s, or -v.
-o	Get files with historic filename if renamed after the specified label or timestamp. Default is to get with current filename.
-p	Full path to repository, including parent repositories. If not specified, default working directory repository is used.
-q	Use quiet mode; does not display results after get.
-r	Recursively get files if Item is a repository or file name includes wildcard characters.
-s	Timestamp to retrieve a historical file version. Retrieves the version that was current at the specified time. Format: yyyymmddhh:mm:ss. If a timestamp is not specified, defaults to the current date and time. Cannot use with -a, -l, or -v.
-t	Timestamp to set on retrieved files: -tcurrent: Set timestamp to current date/time -tmodify: Set timestamp to date/time file was last modified -tcheckin: Set timestamp to date/time file was last checked in
-v	File version to get. Cannot use with -a, -l, or -s.
-w	How to replace local writable files or handle modified files in the working directory that were removed from the server. -wprompt: Prompt before replacing local files with server files or deleting removed files from working directory (default). -wreplace: Automatically overwrite local files with server files or delete local files that were removed from server. -wskip: Do not replace local files with server files or delete local files that were removed from server.
-y	Enter a Surround SCM username and password if you do not want to use the default value. To use single sign-on, enter -y+. If you use an identity provider to authenticate, the provider web page opens if you have not yet authenticated. Authenticate with the provider and then return to the CLI.
-z	Enter the Surround SCM Server host computer address and port number if you do not want to use the default value. IPv6 addresses must be in square brackets. If you received a server settings file from your Surround SCM administrator, enter the path to the XML file instead of entering the server connection information.
+u	Display output in Unicode (Windows only). Output cannot be sent to a file. If output is enabled for all commands, enter +u- to disable it for this command.