checkout
Check out files or repositories when you need to make changes. Surround SCM copies a read-write version of the file into the working directory.
sscm checkout Item1 [Item2...] [-bBranch] [-ccComment|-cpCommentPath|-c-] [-e] [-f] [-h] [-pRepository] [-q|-q+|-q-] [-r] [-tcurrent|-tmodify|-tcheckin] [-vVersion] [-wprompt|-wreplace|-wskip] [-xChangelist] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
Item | Files or repository to check out. Enter / to use repository in -p or the default working directory repository. Use quotes in Unix if Item includes wildcard characters. |
-b | Branch that contains files or repository. If not specified, default working directory branch is used. |
-c | Enter a comment or the comment text file path. Enter -cc to prompt for comment, -cp to prompt for the comment file path, or -c- if a comment is not needed. CommentPath can be full path of a local text file, partial path if file is in a subdirectory of current directory, or file name if file is in current directory. |
-e | Check out files exclusively so other users cannot check them out. |
-f | Force file retrieval from server. |
-h | Display online help for the command. |
-p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
-q | Use quiet mode to skip all prompts and results. Enter -q+ to display prompts without results. Enter -q- to skip prompts but display results. |
-r | Recursively check out files if Item is a repository or file name includes wildcard characters. |
-t | Timestamp to set on checked out files: -tcurrent: Current time -tmodify: Time file was last modified -tcheckin: Time file was last checked in |
-v | File version to check out. |
-w | How to replace writable or modified working directory files: -wprompt: Prompt before replacing working directory files with server files (default) -wreplace: Automatically overwrite working directory files with server files -wskip: Do not replace working directory files with server files |
-x | Changelist to add the file to. |
-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. |