Section 15.3. svnlook

15.3. svnlook

The svnlook program provides an interface for server-side examination of a repository. None of the svnlook commands modify the repository in any way. Most commands can look at both committed revisions and transactions. All commands operate directly on the repository and cannot access the repository remotely.

Online help for each of svnlook's subcommands can be obtained by running the program as: svnlook help [COMMAND].

Options

• --version

  Outputs version information about svnlook.

Subcommands

The svnlook commands (with alternate names in parenthesis) are

• author

• cat

• changed

• date

• diff

• dirs-changed

• help (?, h)

• history

• info

• log

• propget (pget, pg)

• proplist (plist, pl)

• tree

• uuid

• youngest

15.3.1. svnlook author

Prints out the username of the author of the given revision or transaction.

Basic Usage

 $ svnlook author -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --TRansaction are mutually exclusive.

• -t --TRansaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.2. svnlook cat

Outputs the contents of the given file in the repository.

Basic Usage

 $ svnlook cat REPOSITORY FILE 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --TRansaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.3. svnlook changed

Prints out all of the paths that were changed in a given revision or transaction.

Basic Usage

 $ svnlook changed -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.4. svnlook date

Prints out the date when a revision or transaction was created.

Basic Usage

 $ svnlook date -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.5. svnlook diff

Prints out a diff of all the changes that occurred in a given revision or transaction.

Basic Usage

 $ svnlook diff -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

• --no-diff-deleted

  If a file has been deleted, don't print the differences. This prevents an entire file from being dumped if it has been deleted.

15.3.6. svnlook dirs-changed

Prints out all of the directories that had their properties modified, or had files contained therein modified, in the given revision or transaction.

Basic Usage

 $ svnlook dirs-changed -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --TRansaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.7. svnlook help (?, h)

This command outputs documentation for the svnlook command. To get help on a specific sub-command, run help with the name of the command.

Basic Usage

 $ svnlook help [COMMAND] 

Options

None

15.3.8. svnlook history

Shows the revisions where changes were made to the supplied path in the repository.

Basic Usage

 $ svnlook history REPOSITORY [PATH] 

If no PATH is given, the history for the root of the repository is shown.

Options

• -r --revision] arg

  Indicate the revision that the command should look at.

• --show-ids

  Tell Subversion to show the node revision IDs for each entry listed in the history output.

15.3.9. svnlook info

Prints out information about the given revision. Information consists of the author of the revision, the datestamp, the size of the log message, and the log message.

Basic Usage

 $ svnlook info -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --TRansaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.10. svnlook log

Prints out the log message for a given revision.

Basic Usage

 $ svnlook log -r REVISION REPOSITORY 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.11. svnlook propget (pget, pg)

Prints out the value for a given property (prints versioned properties only, not revision properties).

Basic Usage

 $ svnlook propget -r REVISION REPOSITORY PROP_NAME PATH 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --TRansaction are mutually exclusive.

• -t --TRansaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

15.3.12. svnlook proplist (plist, pl)

Lists all of the properties that have been set for a given file or directory in the repository. This command only works to list versioned properties. It does not have a way to list the revision properties set on a specific revision.

Basic Usage

 $ svnlook proplist -r REVISION REPOSITORY PATH 

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --TRansaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

• -v --verbose]

  Print out the property values, in addition to the property names.

15.3.13. svnlook tree

Prints out the file/directory tree for a repository, at a given revision. If a path is supplied, the tree relative to that path is shown.

Basic Usage

 $ svnlook tree -r REVISION REPOSITORY [PATH] 

If no PATH is given, the tree is shown for the root of the repository.

Options

• -r --revision] arg

  Indicate the revision that the command should look at. This option and --transaction are mutually exclusive.

• -t --transaction] arg

  Indicate the transaction that the command should look at. This option and --revision are mutually exclusive.

• --show-ids

  Tell Subversion to show the node revision IDs for each entry listed in the tree output.

15.3.14. svnlook uuid

Prints out the universal unique identifier (UUID) for the given repository.

Each repository has a UUID, which is used by the Subversion client to uniquely identify a given repository. This allows the Subversion client to know if it is accessing the same repository, even after the URL changes. It also allows the Subversion client to prevent you from running a Subversion command that crosses repository boundaries (inter-repository communication is not supported by Subversion).

Basic Usage

 $ svnlook uuid REPOSITORY 

Options

None

15.3.15. svnlook youngest

Prints out the most recently committed revision in the given repository.

Basic Usage

 $ svnlook youngest REPOSITORY 

Options

None