git.maemo.org Git - samba/blob - docs/htmldocs/manpages/smbget.1.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbget</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbget.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbget &#8212; wget-like utility for download files over SMB</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">smbget</code>  [-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/] [...]</p></div></div><div class="refsect1" lang="en"><a name="id2450696"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p>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.
   2         </p><p>
   3                 The files should be in the smb-URL standard, e.g. use smb://host/share/file
   4                 for the UNC path <span class="emphasis"><em>\\\\HOST\\SHARE\\file</em></span>.
   5         </p></div><div class="refsect1" lang="en"><a name="id2450730"></a><h2>OPTIONS</h2><dt><span class="term">-a, --guest</span></dt><dd><p>Work as user guest</p></dd><dt><span class="term">-r, --resume</span></dt><dd><p>Automatically resume aborted files</p></dd><dt><span class="term">-R, --recursive</span></dt><dd><p>Recursively download files</p></dd><dt><span class="term">-u, --username=STRING</span></dt><dd><p>Username to use</p></dd><dt><span class="term">-p, --password=STRING</span></dt><dd><p>Password to use</p></dd><dt><span class="term">-w, --workgroup=STRING</span></dt><dd><p>Workgroup to use (optional)</p></dd><dt><span class="term">-n, --nonprompt</span></dt><dd><p>Don't ask anything (non-interactive)</p></dd><dt><span class="term">-d, --debuglevel=INT</span></dt><dd><p>Debuglevel to use</p></dd><dt><span class="term">-D, --dots</span></dt><dd><p>Show dots as progress indication</p></dd><dt><span class="term">-P, --keep-permissions</span></dt><dd><p>Set same permissions on local file as are set on remote file.</p></dd><dt><span class="term">-o, --outputfile</span></dt><dd><p>Write the file that is being download to the specified file. Can not be used together with -R.</p></dd><dt><span class="term">-f, --rcfile</span></dt><dd><p>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.</p></dd><dt><span class="term">-q, --quiet</span></dt><dd><p>Be quiet</p></dd><dt><span class="term">-v, --verbose</span></dt><dd><p>Be verbose</p></dd><dt><span class="term">-b, --blocksize</span></dt><dd><p>Number of bytes to download in a block. Defaults to 64000.</p></dd><dt><span class="term">-?, --help</span></dt><dd><p>Show help message</p></dd><dt><span class="term">--usage</span></dt><dd><p>Display brief usage message</p></dd></div><div class="refsect1" lang="en"><a name="id2451004"></a><h2>SMB URLS</h2><p> SMB URL's should be specified in the following format:</p><pre class="programlisting">
   6 smb://[[[domain;]user[:password@]]server[/share[/path[/file]]]]
   7 </pre><pre class="programlisting">
   8 smb:// means all the workgroups
   9 </pre><pre class="programlisting">
  10 smb://name/ means, if <em class="replaceable"><code>name</code></em> is a workgroup, all the servers in this workgroup, or if <em class="replaceable"><code>name</code></em> is a server, all the shares on this server.
  11 </pre></div><div class="refsect1" lang="en"><a name="id2451046"></a><h2>EXAMPLES</h2><pre class="programlisting">
  12 # Recursively download 'src' directory
  13 smbget -R smb://rhonwyn/jelmer/src
  14 # Download FreeBSD ISO and enable resuming
  15 smbget -r smb://rhonwyn/isos/FreeBSD5.1.iso
  16 # Recursively download all ISOs
  17 smbget -Rr smb://rhonwyn/isos
  18 # Backup my data on rhonwyn
  19 smbget -Rr smb://rhonwyn/
  20 </pre></div><div class="refsect1" lang="en"><a name="id2451063"></a><h2>BUGS</h2><p>Permission denied is returned in some cases where the cause of the error is unknown
  21 (such as an illegally formatted smb:// url or trying to get a directory without -R
  22 turned on).</p></div><div class="refsect1" lang="en"><a name="id2451076"></a><h2>VERSION</h2><p>This man page is correct for version 3.0 of
  23         the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2451087"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
  24         were created by Andrew Tridgell. Samba is now developed
  25         by the Samba Team as an Open Source project similar
  26         to the way the Linux kernel is developed.</p><p>The smbget manpage was written by Jelmer Vernooij.</p></div></div></body></html>