.TH sy-ls 1 .SH NAME sy\-ls \- lists and filters the current and past file tree .PP .SH SYNOPSIS sy ls [\fB\-V\fR | \fB\-\-versions\fR] [\fB\-t\fR | \fB\-\-types=\fR\fB\fR] [\fB\-D\fR | \fB\-\-date=\fR\fB\fR] [\fB\-r\fR | \fB\-\-recursive\fR] [\fB\-f\fR | \fB\-\-full\-checksums\fR] [\fB\-g\fR | \fB\-\-group\fR] [\fB\-H\fR | \fB\-\-file\-history\fR] [\fB\-q\fR | \fB\-\-deleted\fR] [\fB\fR] .PP .SH DESCRIPTION This command lists and filters the file tree based on the local database. The file tree selection can be performed using the following selection criteria: .PP (1) Using the \fB\fR, one can select a file pattern (such as \fB`*.txt`\fR) or sub tree (such as \fB`subfolder/`\fR, only with \fB\-r\fR). (2) Using \fB\-r\fR, the command does not only list the folder relative to the \fB\fR, but to all sub trees of it. (3) The \fB\-t\fR option limits the result set to a certain file type (\'f\' for files, \'d\' for directories, and \'s\' for symlinks). Types can be combined, e.g. \fB`sy ls \fB\-tfs\fR`\fR selects files and symlinks. (4) The \fB\-D\fR option selects the date/time at which to select the file tree, e.g. \fB`sy ls \fB\-D20m\fR`\fR to select the file tree 20 minutes ago or \fB`sy ls \fB\-D2014\-05\-02\fR`\fR to select the file tree at May 2. (5) The \fB\-H\fR option can be used to select a specific file only. If the option is given, the \fB\fR is interpreted as a file history identifier. (6) The \fB\-q\fR flag will display files that have been deleted from the file system. .PP Using the \fB\-\-versions\fR flag, the command also displays the entire version history for the selected files. Using \fB\-\-group\fR, the result can be grouped by the file history identifier. .PP .SH OPTIONS \fB\-V\fR, \fB\-\-versions\fR .RS Select and display the entire history of the matching files instead of only the last version. Useful with \fB\-\-group\fR. .PP .RE \fB\-t\fR, \fB\-\-types=\fR\fB\fR .RS Limits the result set to a certain file type (\'f\' for files, \'d\' for directories, and \'s\' for symlinks). Types can be combined, e.g. \fB`sy ls \fB\-tfs\fR`\fR selects files and symlinks. Default setting is \'tds\'. .PP .RE \fB\-D\fR, \fB\-\-date=\fR\fB\fR .RS Selects the file tree at a certain date. The date can be given as a relative date to the current time, or an absolute date in form of a timestamp. .PP Absolute date format: .PP Relative date format: \fB\fR\fB\fR, for which \fB\fR may be any floating point number and \fB\fR may be any of the following: s(econds), m(inutes), h(ours), d(ays), w(eeks), mo(nths), y(ears). Units may be shortened if they are unique. Examples: 5h30m or 1y1mo2d .PP .RE \fB\-H\fR, \fB\-\-file\-history\fR .RS If the option is given, the \fB\fR is interpreted as a file history identifier. This option can be used to select one specific file history. If \fB\-H\fR is given, \fB\-V\fR is automatically switched on. .PP .RE \fB\-r\fR, \fB\-\-recursive\fR .RS Not only selects the folder relative to the \fB\fR, but to all sub trees of it. .PP .RE \fB\-q\fR, \fB\-\-deleted\fR .RS Also selects files that have been deleted from the file system, but are still kept in the database. These files can be restored using the \fB`sy restore`\fR command. By default, deleted files are not displayed. .PP .RE \fB\-g\fR, \fB\-\-group\fR .RS Only works with \fB\-\-versions\fR. Displays the file versions grouped by file history. .PP .RE \fB\-f\fR, \fB\-\-full\-checksums\fR .RS Displays full/long checksums instead of shortened checksums. .PP .RE \fB\fR .RS Selects a file pattern or sub tree of the database using substring and wildcard mechanisms. The expression is applied to the relative slash\- separated path. The only possible wildcard is * (equivalent: ^). .PP If \fB\fR does not contain a wildcard, it is interpreted as prefix and extended to \fB`\fB\fR*`\fR. If a wildcard is present, no wildcard is appended. .PP Note: The Linux shell expands the * wildcard if a matching file is present. Either use single quotes (e.g. \'*.txt\') or use ^ instead. .PP .RE .SH EXAMPLES sy ls \fB\-r\fR subfolder/ .RS Selects all file entries of the current file tree in the folder \'subfolder/\', including for instance \'subfolder/some/other/file.txt\'. .PP .RE sy ls \fB\-\-recursive\fR \fB\-\-types=\fRfs \fB\-\-date=\fR1h30m \'*.txt\' .RS Selects all files and symlinks in the entire file tree that end with .txt and existed one and 30 minutes hour ago. .PP .RE sy ls \fB\-\-versions\fR \fB\-\-group\fR \fB\-\-recursive\fR .RS Selects and displays all file versions and their file histories. This selects the entire database. Use with caution. .PP .RE .SH COPYRIGHT Syncany 0.4.9\-alpha, Distributed under GPLv3, Copyright (c) 2011\-2015 Philipp C. Heckel