label
Label a file or repository to mark a specific version. You can create labels for single files, multiple files, or all files in a repository. A new entry is created in the history but file and the version number do not change.
sscm label Item1 [Item2 ...] [-bBranch] [-ccComment|-cpCommentPath|-c-] [-h] [-lLabel] [-o] [-pRepository] [-r] [-sTimeStamp|-vVersion] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
Item | Files or repository to label. Enter / to use repository specified 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. |
-h | Display online help for the command. |
-l | Label to apply to files. If the label does not exist, it will be created. |
-o | Remove label from previous versions. |
-p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
-r | Recursively label all files and subrepositories in specified repository or all files that match the file name that includes wildcard characters. |
-s | Label files based on a timestamp. Labels the version that was current at the specified time. Format: yyyymmddhh:mm:ss. Cannot be used with -v. |
-v | Label a version of a single file. For multiple files, option is ignored and all current versions are labeled. Cannot be used with -s. |
-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. |