release/src-rt-6.x.4708/router/samba-3.0.25b/docs/manpages/smbget.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "SMBGET" 1 "" "" ""
  21 .SH "NAME"
  22 smbget - wget-like utility for download files over SMB
  23 .SH "SYNOPSIS"
  24 .HP 1
  25 smbget [-a, --guest] [-r, --resume] [-R, --recursive] [-u, --username=STRING] [-p, --password=STRING] [-w, --workgroup=STRING] [-n, --nonprompt] [-d, --debuglevel=INT] [-D, --dots] [-P, --keep-permissions] [-o, --outputfile] [-f, --rcfile] [-q, --quiet] [-v, --verbose] [-b, --blocksize] [-?, --help] [--usage] {smb://host/share/path/to/file} [smb://url2/] [...]
  26 .SH "DESCRIPTION"
  27 .PP
  28 This tool is part of the
  29 \fBsamba\fR(7)
  30 suite.
  31 .PP
  32 smbget is a simple utility with wget-like semantics, that can download files from SMB servers. You can specify the files you would like to download on the command-line.
  33 .PP
  34 The files should be in the smb-URL standard, e.g. use smb://host/share/file for the UNC path
  35 \fB\\\\HOST\\SHARE\\file\fR.
  36 .SH "OPTIONS"
  37 .PP
  38 -a, --guest
  39 .RS 3n
  40 Work as user guest
  41 .RE
  42 .PP
  43 -r, --resume
  44 .RS 3n
  45 Automatically resume aborted files
  46 .RE
  47 .PP
  48 -R, --recursive
  49 .RS 3n
  50 Recursively download files
  51 .RE
  52 .PP
  53 -u, --username=STRING
  54 .RS 3n
  55 Username to use
  56 .RE
  57 .PP
  58 -p, --password=STRING
  59 .RS 3n
  60 Password to use
  61 .RE
  62 .PP
  63 -w, --workgroup=STRING
  64 .RS 3n
  65 Workgroup to use (optional)
  66 .RE
  67 .PP
  68 -n, --nonprompt
  69 .RS 3n
  70 Don't ask anything (non-interactive)
  71 .RE
  72 .PP
  73 -d, --debuglevel=INT
  74 .RS 3n
  75 Debuglevel to use
  76 .RE
  77 .PP
  78 -D, --dots
  79 .RS 3n
  80 Show dots as progress indication
  81 .RE
  82 .PP
  83 -P, --keep-permissions
  84 .RS 3n
  85 Set same permissions on local file as are set on remote file.
  86 .RE
  87 .PP
  88 -o, --outputfile
  89 .RS 3n
  90 Write the file that is being download to the specified file. Can not be used together with -R.
  91 .RE
  92 .PP
  93 -f, --rcfile
  94 .RS 3n
  95 Use specified rcfile. This will be loaded in the order it was specified - e.g. if you specify any options before this one, they might get overriden by the contents of the rcfile.
  96 .RE
  97 .PP
  98 -q, --quiet
  99 .RS 3n
 100 Be quiet
 101 .RE
 102 .PP
 103 -v, --verbose
 104 .RS 3n
 105 Be verbose
 106 .RE
 107 .PP
 108 -b, --blocksize
 109 .RS 3n
 110 Number of bytes to download in a block. Defaults to 64000.
 111 .RE
 112 .PP
 113 -?, --help
 114 .RS 3n
 115 Show help message
 116 .RE
 117 .PP
 118 --usage
 119 .RS 3n
 120 Display brief usage message
 121 .RE
 122 .SH "SMB URLS"
 123 .PP
 124 SMB URL's should be specified in the following format:
 125 .PP
 126
 127 .sp
 128
 129 .nf
 130
 131 smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]
 132
 133 .fi
 134
 135 .PP
 136
 137 .sp
 138
 139 .nf
 140
 141 smb:// means all the workgroups
 142
 143 .fi
 144
 145 .PP
 146
 147 .sp
 148
 149 .nf
 150
 151 smb://name/ means, if \fIname\fR is a workgroup, all the servers in this workgroup, or if \fIname\fR is a server, all the shares on this server.
 152
 153 .fi
 154
 155 .SH "EXAMPLES"
 156
 157 .nf
 158
 159 # Recursively download 'src' directory
 160 smbget -R smb://rhonwyn/jelmer/src
 161 # Download FreeBSD ISO and enable resuming
 162 smbget -r smb://rhonwyn/isos/FreeBSD5.1.iso
 163 # Recursively download all ISOs
 164 smbget -Rr smb://rhonwyn/isos
 165 # Backup my data on rhonwyn
 166 smbget -Rr smb://rhonwyn/
 167
 168 .fi
 169 .SH "BUGS"
 170 .PP
 171 Permission denied is returned in some cases where the cause of the error is unknown (such as an illegally formatted smb:// url or trying to get a directory without -R turned on).
 172 .SH "VERSION"
 173 .PP
 174 This man page is correct for version 3.0 of the Samba suite.
 175 .SH "AUTHOR"
 176 .PP
 177 The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
 178 .PP
 179 The smbget manpage was written by Jelmer Vernooij.
 180