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 (-u), it adds working revision and server out-of-date information. With --verbose (-v), it prints full revision information on every item. With --quiet (-q), it prints only summary information about locally modified items.

The first seven columns in the output are each one character wide, and each column gives you information about a different aspect of each working copy item.

The first column indicates that an item was added, deleted, or otherwise changed:

The second column tells the status of a file's or directory's properties:

The third column is populated only if the working copy directory is locked (see the section called “Sometimes You Just Need to Clean Up”):

The fourth column is populated only if the item is scheduled for addition-with-history:

The fifth column is populated only if the item is switched relative to its parent (see the section called “Traversing Branches”):

The sixth column is populated with lock information:

The seventh column is populated only if the item is the victim of a tree conflict:

The eighth column is always blank.

The out-of-date information appears in the ninth column (only if you pass the --show-updates (-u) option):

The remaining fields are variable width and delimited by spaces. The working revision is the next field if the --show-updates (-u) or --verbose (-v) option is passed.

If the --verbose (-v) option 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.

Options

--changelist (--cl) ARG
--depth ARG
--ignore-externals
--incremental
--no-ignore
--quiet (-q)
--show-updates (-u)
--verbose (-v)
--xml

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 (-u) option (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 -u wc
 M            965    wc/bar.c
        *     965    wc/foo.c
A  +          965    wc/qax.c
Status against revision:    981

	Note
	--show-updates (-u) only places an asterisk next to items that are out of date (i.e., items that will be updated from the repository if you later use svn update). --show-updates (-u) does not cause the status listing to reflect the repository's version of the item (although you can see the revision number in the repository by passing the --verbose (-v) option).

The most information you can get out of the status subcommand is as follows:

$ svn status -u -v 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
Status against revision:   981

Lastly, you can get svn status output in XML format with the --xml option:

$ svn status --xml wc
<?xml version="1.0"?>
<status>
<target
   path="wc">
<entry
   path="qax.c">
<wc-status
   props="none"
   item="added"
   revision="0">
</wc-status>
</entry>
<entry
   path="bar.c">
<wc-status
   props="normal"
   item="modified"
   revision="965">
<commit
   revision="965">
<author>sally</author>
<date>2008-05-28T06:35:53.048870Z</date>
</commit>
</wc-status>
</entry>
</target>
</status>

For many more examples of svn status, see the section called “See an overview of your changes”.