You can show all projects in the database that
match specific criteria. If no query-related options are specified,
all projects are shown.
Each query-related
option is used to construct a query expression. For example, -name
name results in a query expression of name='name'.
If the same option is repeated, the query clauses are combined with
an or. For example -name example.txt -name
another.txt results in a query expression "(name='example.txt'
or name='another.txt')."
Query clauses
for different options are combined with and. For
example, -n example.txt -s working results in a query
expression "(name='example.txt') and (status='working')".
About this task
ccm show -p|-projects [(-o|-owner owner)...] [(-n|-name name)...]
[(-v|-version version)...] [(-s|-state state)...]
[(-task task_spec)...] [-f|-format format] [-nf|-noformat]
([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator] ([-sby|-sortby sortspec] |
[-ns|-nosort|-no_sort]) [-gby|-groupby groupformat] [-u|-unnumbered]
- -ch|-column_header
- Specifies to use a column header in the output format. See -ch|-column_header for details.
- -f|-format format
- Specifies the command output format. See -f|-format for details.
A
keyword can be built in (%fullname, %displayname, %objectname)
or the name of any existing attribute such as %modify_time or %status.
See Built-in keywords for a list of keywords.
- -gby|-groupby groupformat
- Specifies how to group the command output. See -gby|-groupby for details.
- -n|-name name
- Includes a query clause of the form "name='name'"
to find projects with the specified name.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See -nch|-nocolumn_header for details.
- -nf|-noformat
- Specifies not to use column alignment. See -nf|-noformat for details.
- -ns|-nosort|-no_sort
- Specifies not to sort the command output. See -nf|-noformat for details.
- -o|-ownerowner
- Includes a query clause of the form "owner='owner'"
to find projects with the specified owner.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See -sby|-sortby for details.
- -sep|-separator separator
- Used only with the -f|-format option. Specifies
a different separator character. See -sep|-separator for details.
- -s|-statestate
- Includes a query clause of the form "status='state'"
to find projects with the specified status.
- -task task_spec
- Includes a query clause of the form "is_associated_cv_of(task('task_spec'))"
to find the associated projects of the specified task. You can set task_spec to
one or more tasks. See Task specification for details.
- -u|-unnumbered
- Suppresses automatic numbering of the command output. See -u|-unnumbered for details.
- -v|-version version
- Includes a query clause of the form "version='version'"
to find projects with the specified version.
Example
- Show projects in
the database that have the status integrate and
owner john.
ccm show -p
-s integrate -o john
1) projY-1 integrate john project
projY 1 2
2) projY-2 integrate john project projY 1
7
3) projY-2.1 integrate john project projY 1 8
- Show projects in the database that have the status integrate,
owner john, and are associated with task 8.
ccm show -p -s integrate -o john -task 8
1) projY-2.1 integrate john project projY 1 8
- Show the types defined in the database.
ccm show -t
ascii
binary
c++
csrc
dir
executable
incl
library
lsrc
makefile
project
relocatable_obj
shared_library
shsrc
symlink (UNIX)
ysrc