Show a list of file revisions
Overview
Allows a user to query information about one or more file
revisions and perform basic formatting. The ls engine is
reused throughout the CodeMatrix system wherever a filespec
is supplied, so the results generated by ls will match
other filespec based commands, e.g. branch, workspace,
associate etc. The columns in the output are placed in the
order determined by the order of the related options in
the request. Returned values that contain spaces are
returned in
quotes.
The set of file revisions returned may be further modified
by applying a filter.
Syntax
| |
ls [-riCOdeEGhHIklmMnNoPRStTuUvyYzZA][-A(item)][-c
][filespec] |
Control options
| r |
Include files from subdirectoies. |
| i |
Ignore the case of names. |
| c |
The column separator - default is space. |
| O |
The passed path is a folder, workspace or
branch, return details about this, not its
contents. |
| h |
Include all
matching revisions in the current branch. |
| H |
Include all
matching revisions in this and any parent
branches/folders. |
Column specification options
| A(item) |
Returns an ad hoc data
item from the object |
| C |
Created date and time |
| d |
Revised date |
| e |
3 character object
type abbreviation |
| E |
Object type |
| G |
Change number |
| I |
Revision
comment |
|
k |
Revision
state |
| |
- = not mounted
N = mounted on client computer
Y = mounted & checked out on client
computer
n = mounted on another computer
y = mounted & checked out on another
computer |
| l |
Long
report (same as dyovkR) |
| m |
Computer name that file is mounted
on |
| M |
Modified date and time |
| n |
Name of the object (without
the path) |
|
N |
Number of immediate children |
|
o |
Internal object id |
|
P |
Full name of the object
in the repository |
|
R |
Relative name the
object in the
repository |
|
S |
Full physical name
of the folder in
which the object is
stored on the server
|
|
t |
Revised time |
|
T |
Revised date &
time |
|
u |
Checksum |
|
U |
User that
created
revision |
|
v |
Revision
number |
|
W |
Whether
object
is in a
workspace
(Y/N) |
|
y |
3
character
file
class
abbreviation |
|
Y |
File
class |
|
z |
Formatted
file
size |
|
Z |
Unformatted
file
size |
| |
|
Filespecs
Files
in
the
CodeMatrix
system
exist
in
single
hierarchical
namespace
with
//
as
the
root.
Each
folder
in
a
name
is
separated
by
a
'/'
character.
A
filespec
identifies
a
set
of
files
either
by
the
full
name,
a
name
relative
to
the
current
working
directory,
and
may
include
the
wildcard
characters
'?'
and
'*'.
'?'
matches
a
single
character
at
the
given
position,
'*'
matches
any
number
of
characters.
A
parent
folder
can
be
referenced
as
"..".
Filespec examples
1)
A
fully
qualified
name
2)
A
fully
qualified
path
with
wild
card
characters
3)
A
relative
path
| |
cd //cx/source/
ls xyz.cpp
|
4)
A
fully
qualified
nameA
relative
path
including
a
parent
folder
| |
cd //cx/misc/
ls ../source/xyz.cpp
|
Examples
| |
ls -A(fullname) //Admin/Users/fred |
Returns
the
full
name
of
the
User
fred
Generates
a
list
of
all
files
in
the
folder
//cx/source
and
all
subfolders
with
2
columns,
name
and
revised
time.
|
