CHECKOUT
Description
Marks files as ready to modify.
Usage
cm checkout | co [<item_path>[ ...]] [-R | -r | --recursive] [--format=<str_format>] [--errorformat=<str_format>] [--resultformat=<str_format>] [--silent] [--symlink] [--ignorefailed] [--machinereadable [--startlineseparator=<sep>] [--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Options
Option / Argument | Description |
---|---|
item_path | Items to be checked-out. Use double quotes (" ") to specify paths containing spaces. Use a whitespace to separate item paths. Use . to apply checkout to current directory. |
-R | Checks out files recursively. |
--format | Retrieves the output progress message in a specific format. Check the examples for more information. |
--resultformat | Retrieves the output result message in a specific format. Check the examples for more information. |
--silent | Does not show any output at all. |
--symlink | Applies the checkout operation to the symlink and not to the target. |
--ignorefailed | If an item cannot be locked (the exclusive checkout cannot be performed), the checkout operation will continue without it. |
--machinereadable | Outputs the result in an easy-to-parse format. |
--startlineseparator | Used with the '--machinereadable' flag, specifies how the lines should start. |
--endlineseparator | Used with the '--machinereadable' flag, specifies how the lines should end. |
--fieldseparator | Used with the '--machinereadable' flag, specifies how the fields should be separated. |
Help
Remarks
To checkout an item
- The item must be under source code control.
- The item must be checked-in.
If locks are configured on the server (lock.conf exists), then each time a checkout on a path happens, Unity VCS checks if it meets any of the rules and if so, the path will be in exclusive checkout (locked) so that none can simultaneously checkout. You can get all the locks in the server by using 'cm lock list'. See the Administrator Guide for more information:
https://www.plasticscm.com/download/help/adminguide
The format string replaces the placeholder '{0}' with the path of the item being checked out. Check the examples to see how to use it.
Reading input from stdin
The 'checkout' command can read paths from stdin. To do this, pass a single dash "-". Example: cm checkout -
Paths will be read until an empty line is entered. This allows you to use pipe to specify which files to checkout. Example:
dir /S /B *.c | cm checkout -
(In Windows, checkouts all .c files in the workspace.)
Examples
cm checkout file1.txt file2.txt
(Checkouts 'file1.txt' and 'file2.txt' files.)
cm co *.txt
(Checkouts all txt files.)
cm checkout .
(Checkouts current directory.)
cm checkout -R c:\workspace\src
(Recursively checkouts 'src' folder.)
cm co file.txt --format="Checking out item {0}" --resultformat="Item {0} checked out"
(Checkouts 'file.txt' using the specified formatting strings to show the progress and the result of the operation.)
cm checkout link --symlink
(Checkouts the symlink file and not the target.)
cm checkout . -R --ignorefailed
(Recursively checkouts the current folder, ignoring those files that can not be checked out.)
cm co . --machinereadable --startlineseparator=">"
(Checkouts the current directory, and prints the result in a simplified, easier-to-parse format, starting the lines with the specified strings.)