Name
svn status — Print the status of working copy files and directories.
Synopsis
svn status [PATH...]
Description
Print the status of working copy files and
directories. With no arguments, it prints only locally
modified items (no repository access). With
--show-updates, add working revision
and server out-of-date information. With
--verbose, print full revision
information on every item.
The first six columns in the output are each one
character wide, and each column gives you information
about different aspects of each working copy item.
The first column indicates that an item
was added, deleted, or otherwise changed.
-
' '
-
No modifications.
-
'A'
-
Item is scheduled for Addition.
-
'D'
-
Item is scheduled for Deletion.
-
'M'
-
Item has been modified.
-
'R'
-
Item has been replaced in your working copy.
-
'C'
-
The contents (as opposed to the properties) of
the item conflict with updates received from the
repository.
-
'X'
-
Item is related to an externals definition.
-
'I'
-
Item is being ignored (e.g. with the
svn:ignore property).
-
'?'
-
Item is not under version control.
-
'!'
-
Item is missing (e.g. you moved or deleted it
without using
svn
). This also
indicates that a directory is incomplete (a checkout
or update was interrupted).
-
'~'
-
Item is versioned as one kind of object (file,
directory, link), but has been replaced by different
kind of object.
The second column tells the status of a file's or
directory's properties.
-
' '
-
No modifications.
-
'M'
-
Properties for this item have been
modified.
-
'C'
-
Properties for this item are in conflict with
property updates received from the
repository.
The third column is populated only if the
working copy directory is locked.
-
' '
-
Item is not locked.
-
'L'
-
Item is locked.
The fourth column is populated only if the item is
scheduled for addition-with-history.
-
' '
-
No history scheduled with commit.
-
'+'
-
History scheduled with commit.
The fifth column is populated only if the item is
switched relative to its parent (see
the section called “Switching a Working Copy”).
-
' '
-
Item is a child of its parent directory.
-
'S'
-
Item is switched.
The sixth column is populated with lock information.
-
' '
-
When --show-updates is used,
the file is not locked. If
--show-updates is
not
used, this merely means that
the file is not locked in this working copy.
-
K
-
File is locked in this working copy.
-
O
-
File is locked either by another user or in
another working copy. This only appears when
--show-updates is used.
-
T
-
File was locked in this working copy, but the
lock has been “stolen”and is invalid.
The file is currently locked in the repository. This
only appears when --show-updates is
used.
-
B
-
File was locked in this working copy, but the
lock has been “broken”and is invalid.
The file is no longer locked This only appears when
--show-updates is used.
The out-of-date information appears in the seventh
column (only if you pass the
--show-updates switch).
-
' '
-
The item in your working copy is up-to-date.
-
'*'
-
A newer revision of the item exists on the
server.
The remaining fields are variable width and
delimited by spaces. The working revision is the next
field if the --show-updates or
--verbose switches are passed.
If the --verbose switch is passed,
the last committed revision and last committed author
are displayed next.
The working copy path is always the final field, so
it can include spaces.
Accesses Repository
Only if using --show-updates
Switches
--show-updates (-u)
--verbose (-v)
--non-recursive (-N)
--quiet (-q)
--no-ignore
--username USER
--password PASS
--no-auth-cache
--non-interactive
--config-dir
--ignore-externals
Examples
This is the easiest way to find out what changes you
have made to your working copy:
$ svn status wc
M wc/bar.c
A + wc/qax.c
If you want to find out what files in your working
copy are out-of-date, pass the
--show-updates switch (this will
not
make any changes to your
working copy). Here you can see that
wc/foo.c has changed in the
repository since we last updated our working
copy:
$ svn status --show-updates wc
M 965 wc/bar.c
* 965 wc/foo.c
A + 965 wc/qax.c
Status against revision: 981
Note
--show-updates
only
places an asterisk next to
items that are out of date (that is, items that will be
updated from the repository if you run
svn
update
). --show-updates does
not
cause the status listing to
reflect the repository's version of the item.
And finally, the most information you can get out of
the status subcommand:
$ svn status --show-updates --verbose wc
M 965 938 sally wc/bar.c
* 965 922 harry wc/foo.c
A + 965 687 harry wc/qax.c
965 687 harry wc/zig.c
Head revision: 981
For many more examples of
svn status
,
see
the section called “
svn status
”.
