• Name

    svn list – List directory entries in the repository.

    Synopsis

    svn list [TARGET[@REV]…]

    Description

    List each TARGET file and the contents of each TARGET directory as they exist in the repository. If TARGET is a working copy path, the corresponding repository URL will be used.

    The default TARGET is “.”, meaning the repository URL of the current working copy directory.

    With --verbose, svn list shows the following fields for each item:

    • Revision number of the last commit

    • Author of the last commit

    • If locked, the letter “O” (See svn info for details).

    • Size (in bytes)

    • Date and time of the last commit

    With --xml, output is in XML format (with a header and an enclosing document element unless --incremental is also specified). All of the information is present; the --verbose option is not accepted.

    Alternate Names

    ls

    Changes

    Nothing

    Accesses Repository

    Yes

    Options

    --revision (-r) REV
    --verbose (-v)
    --recursive (-R)
    --incremental
    --xml
    --username USER
    --password PASS
    --no-auth-cache
    --non-interactive
    --config-dir DIR
    

    Examples

    svn list is most useful if you want to see what files a repository has without downloading a working copy:

    $ svn list http://svn.red-bean.com/repos/test/support
    README.txt
    INSTALL
    examples/
    …
    

    You can pass the --verbose option for additional information, rather like the UNIX command ls -l:

    $ svn list --verbose file:///tmp/repos
         16 sally         28361 Jan 16 23:18 README.txt
         27 sally             0 Jan 18 15:27 INSTALL
         24 harry               Jan 18 11:27 examples/
    

    For further details, see the section called “svn list.


    The Version Control with Subversion book is licensed under the Creative Commons Attribution License v2.0.
    To submit comments, corrections, or other contributions to the text, please visit http://www.svnbook.com.