ls
Display repository information to see its contents or view file information to see the status, file type, last check in date and time, check out user, and check out location. Optionally include local and server file version information. If Item is a repository, all files and subrepositories are displayed. If Item is not a repository, it is assumed to be a regular expression used to search for file names.
sscm ls [Item] [-bBranch] [-cFieldID:FieldValue] [-fFilterName] [-h] [-pRepository] [-r] [-eEventText] [-aEventType] [-lLabelText] [-m[F|E|L|FEL]] [-x[F|E|L|FEL]] [-uCheckoutUser] [-v] [-w] [-s[c|i|m|o|u]] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath] [+u]
Option | Description |
---|---|
Item | File or repository to view information for. Enter / to use repository specified in -p or the default working directory repository. Use quotes in Unix if Item includes wildcard characters. |
-a | Action to search for. Actions include: AddToRepository, AddToBranch, AddFromBranch, AttachToIssue, AttachToTestCase, AttachToRequirement, AttachToExternal, BreakShare, CheckIn, FileDestroyed, FileRenamed, Label, Promote, PromoteFrom, Rebase, RebaseWithMerge, Remove, RepoDestroyed, RepoMoved, RepoRenamed, Restore, Share, RollbackFile, RollbackRebase, and RollbackPromote. |
-b | Branch that contains files or repository. If not specified, default working directory branch is used. |
-c | Custom field ID and value to search for. Use lscustomfield to find field ID. DateTime field format: yyyymmddhh:mm:ss. |
-e | Comment to search for. |
-f | Filter to use for search. |
-h | Display online help for the command. |
-l | Label to search for. |
-m | Perform a case-sensitive search. F: Case-sensitive search on a file name E: Case-sensitive search on a comment L: Case-sensitive search on a label |
-p | Full path to repository, including parent repositories. If not specified, default working directory repository is used. |
-r | Recursively display a list of all files and subrepositories. |
-s | File status to search for. c: Current i: Missing m: Modified o: Old u: Unknown |
-u | Username files or repository are checked out to. Enter * for all users. |
-v | Display file version information. Local file version information is only displayed when it is different from the server version and is appended after the file status separated with '#'. Server file version is displayed in a separate column. |
-w | Display working directories. |
-x | Interpret search criteria as a regular expression. F: Interpret file name as regex E: Interpret comment as regex L: Interpret label as regex |
-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. |