github.com/advanderveer/restic@v0.8.1-0.20171209104529-42a8c19aaea6/doc/man/restic-ls.1 (about)

     1  .TH "restic backup" "1" "Jan 2017" "generated by `restic generate`" "" 
     2  .nh
     3  .ad l
     4  
     5  
     6  .SH NAME
     7  .PP
     8  restic\-ls \- List files in a snapshot
     9  
    10  
    11  .SH SYNOPSIS
    12  .PP
    13  \fBrestic ls [flags] [snapshot\-ID ...]\fP
    14  
    15  
    16  .SH DESCRIPTION
    17  .PP
    18  The "ls" command allows listing files and directories in a snapshot.
    19  
    20  .PP
    21  The special snapshot\-ID "latest" can be used to list files and directories of the latest snapshot in the repository.
    22  
    23  
    24  .SH OPTIONS
    25  .PP
    26  \fB\-h\fP, \fB\-\-help\fP[=false]
    27      help for ls
    28  
    29  .PP
    30  \fB\-H\fP, \fB\-\-host\fP=""
    31      only consider snapshots for this \fB\fChost\fR, when no snapshot ID is given
    32  
    33  .PP
    34  \fB\-l\fP, \fB\-\-long\fP[=false]
    35      use a long listing format showing size and mode
    36  
    37  .PP
    38  \fB\-\-path\fP=[]
    39      only consider snapshots which include this (absolute) \fB\fCpath\fR, when no snapshot ID is given
    40  
    41  .PP
    42  \fB\-\-tag\fP=[]
    43      only consider snapshots which include this \fB\fCtaglist\fR, when no snapshot ID is given
    44  
    45  
    46  .SH OPTIONS INHERITED FROM PARENT COMMANDS
    47  .PP
    48  \fB\-\-cacert\fP=[]
    49      path to load root certificates from (default: use system certificates)
    50  
    51  .PP
    52  \fB\-\-cache\-dir\fP=""
    53      set the cache directory
    54  
    55  .PP
    56  \fB\-\-json\fP[=false]
    57      set output mode to JSON for commands that support it
    58  
    59  .PP
    60  \fB\-\-limit\-download\fP=0
    61      limits downloads to a maximum rate in KiB/s. (default: unlimited)
    62  
    63  .PP
    64  \fB\-\-limit\-upload\fP=0
    65      limits uploads to a maximum rate in KiB/s. (default: unlimited)
    66  
    67  .PP
    68  \fB\-\-no\-cache\fP[=false]
    69      do not use a local cache
    70  
    71  .PP
    72  \fB\-\-no\-lock\fP[=false]
    73      do not lock the repo, this allows some operations on read\-only repos
    74  
    75  .PP
    76  \fB\-o\fP, \fB\-\-option\fP=[]
    77      set extended option (\fB\fCkey=value\fR, can be specified multiple times)
    78  
    79  .PP
    80  \fB\-p\fP, \fB\-\-password\-file\fP=""
    81      read the repository password from a file (default: $RESTIC\_PASSWORD\_FILE)
    82  
    83  .PP
    84  \fB\-q\fP, \fB\-\-quiet\fP[=false]
    85      do not output comprehensive progress report
    86  
    87  .PP
    88  \fB\-r\fP, \fB\-\-repo\fP=""
    89      repository to backup to or restore from (default: $RESTIC\_REPOSITORY)
    90  
    91  
    92  .SH SEE ALSO
    93  .PP
    94  \fBrestic(1)\fP