git.maemo.org Git - samba/blob - 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 .ad l
  25 .hy 0
  26 .HP 7
  27 \fBsmbget\fR [\-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/] [\&.\&.\&.]
  28 .ad
  29 .hy
  30
  31 .SH "DESCRIPTION"
  32
  33 .PP
  34 This tool is part of the \fBsamba\fR(7) suite\&.
  35
  36 .PP
  37 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\&.
  38
  39 .PP
  40 The files should be in the smb\-URL standard, e\&.g\&. use smb://host/share/file for the UNC path \fB\\\\\\\\HOST\\\\SHARE\\\\file\fR\&.
  41
  42 .SH "OPTIONS"
  43
  44 .TP
  45 \-a, \-\-guest
  46 Work as user guest
  47
  48 .TP
  49 \-r, \-\-resume
  50 Automatically resume aborted files
  51
  52 .TP
  53 \-R, \-\-recursive
  54 Recursively download files
  55
  56 .TP
  57 \-u, \-\-username=STRING
  58 Username to use
  59
  60 .TP
  61 \-p, \-\-password=STRING
  62 Password to use
  63
  64 .TP
  65 \-w, \-\-workgroup=STRING
  66 Workgroup to use (optional)
  67
  68 .TP
  69 \-n, \-\-nonprompt
  70 Don't ask anything (non\-interactive)
  71
  72 .TP
  73 \-d, \-\-debuglevel=INT
  74 Debuglevel to use
  75
  76 .TP
  77 \-D, \-\-dots
  78 Show dots as progress indication
  79
  80 .TP
  81 \-P, \-\-keep\-permissions
  82 Set same permissions on local file as are set on remote file\&.
  83
  84 .TP
  85 \-o, \-\-outputfile
  86 Write the file that is being download to the specified file\&. Can not be used together with \-R\&.
  87
  88 .TP
  89 \-f, \-\-rcfile
  90 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\&.
  91
  92 .TP
  93 \-q, \-\-quiet
  94 Be quiet
  95
  96 .TP
  97 \-v, \-\-verbose
  98 Be verbose
  99
 100 .TP
 101 \-b, \-\-blocksize
 102 Number of bytes to download in a block\&. Defaults to 64000\&.
 103
 104 .TP
 105 \-?, \-\-help
 106 Show help message
 107
 108 .TP
 109 \-\-usage
 110 Display brief usage message
 111
 112 .SH "SMB URLS"
 113
 114 .PP
 115 SMB URL's should be specified in the following format:
 116
 117 .PP
 118
 119 .nf
 120
 121 smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]
 122 .fi
 123
 124
 125 .PP
 126
 127 .nf
 128
 129 smb:// means all the workgroups
 130 .fi
 131
 132
 133 .PP
 134
 135 .nf
 136
 137 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\&.
 138 .fi
 139
 140
 141 .SH "EXAMPLES"
 142 .nf
 143
 144 # Recursively download 'src' directory
 145 smbget \-R smb://rhonwyn/jelmer/src
 146 # Download FreeBSD ISO and enable resuming
 147 smbget \-r smb://rhonwyn/isos/FreeBSD5\&.1\&.iso
 148 # Recursively download all ISOs
 149 smbget \-Rr smb://rhonwyn/isos
 150 # Backup my data on rhonwyn
 151 smbget \-Rr smb://rhonwyn/
 152 .fi
 153
 154 .SH "BUGS"
 155
 156 .PP
 157 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)\&.
 158
 159 .SH "VERSION"
 160
 161 .PP
 162 This man page is correct for version 3\&.0 of the Samba suite\&.
 163
 164 .SH "AUTHOR"
 165
 166 .PP
 167 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\&.
 168
 169 .PP
 170 The smbget manpage was written by Jelmer Vernooij\&.
 171