source: branches/samba-3.0/docs/manpages/smbget.1@ 104

Last change on this file since 104 was 44, checked in by Paul Smedley, 18 years ago

Update source to 3.0.25b

File size: 3.7 KB
Line 
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"
22smbget - wget-like utility for download files over SMB
23.SH "SYNOPSIS"
24.HP 1
25smbget [-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
28This tool is part of the
29\fBsamba\fR(7)
30suite.
31.PP
32smbget 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
34The 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
40Work as user guest
41.RE
42.PP
43-r, --resume
44.RS 3n
45Automatically resume aborted files
46.RE
47.PP
48-R, --recursive
49.RS 3n
50Recursively download files
51.RE
52.PP
53-u, --username=STRING
54.RS 3n
55Username to use
56.RE
57.PP
58-p, --password=STRING
59.RS 3n
60Password to use
61.RE
62.PP
63-w, --workgroup=STRING
64.RS 3n
65Workgroup to use (optional)
66.RE
67.PP
68-n, --nonprompt
69.RS 3n
70Don't ask anything (non-interactive)
71.RE
72.PP
73-d, --debuglevel=INT
74.RS 3n
75Debuglevel to use
76.RE
77.PP
78-D, --dots
79.RS 3n
80Show dots as progress indication
81.RE
82.PP
83-P, --keep-permissions
84.RS 3n
85Set same permissions on local file as are set on remote file.
86.RE
87.PP
88-o, --outputfile
89.RS 3n
90Write 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
95Use 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
100Be quiet
101.RE
102.PP
103-v, --verbose
104.RS 3n
105Be verbose
106.RE
107.PP
108-b, --blocksize
109.RS 3n
110Number of bytes to download in a block. Defaults to 64000.
111.RE
112.PP
113-?, --help
114.RS 3n
115Show help message
116.RE
117.PP
118--usage
119.RS 3n
120Display brief usage message
121.RE
122.SH "SMB URLS"
123.PP
124SMB URL's should be specified in the following format:
125.PP
126
127.sp
128
129.nf
130
131smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]
132
133.fi
134
135.PP
136
137.sp
138
139.nf
140
141smb:// means all the workgroups
142
143.fi
144
145.PP
146
147.sp
148
149.nf
150
151smb://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
160smbget -R smb://rhonwyn/jelmer/src
161# Download FreeBSD ISO and enable resuming
162smbget -r smb://rhonwyn/isos/FreeBSD5.1.iso
163# Recursively download all ISOs
164smbget -Rr smb://rhonwyn/isos
165# Backup my data on rhonwyn
166smbget -Rr smb://rhonwyn/
167
168.fi
169.SH "BUGS"
170.PP
171Permission 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
174This man page is correct for version 3.0 of the Samba suite.
175.SH "AUTHOR"
176.PP
177The 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
179The smbget manpage was written by Jelmer Vernooij.
180
Note: See TracBrowser for help on using the repository browser.