From 7f8a814c7ad7529a9b1da872927d34ba8ba222f7 Mon Sep 17 00:00:00 2001 From: Andreas Schneider Date: Thu, 30 Mar 2023 13:48:06 +0200 Subject: [PATCH] docs-xml: Update smbget manpage Signed-off-by: Andreas Schneider Reviewed-by: Andrew Bartlett --- docs-xml/manpages/smbget.1.xml | 100 +++++++++++++++------------------ 1 file changed, 45 insertions(+), 55 deletions(-) diff --git a/docs-xml/manpages/smbget.1.xml b/docs-xml/manpages/smbget.1.xml index 9d1db967f96..d7eac27ddb8 100644 --- a/docs-xml/manpages/smbget.1.xml +++ b/docs-xml/manpages/smbget.1.xml @@ -21,14 +21,9 @@ smbget -a, --guest -r, --resume - -R, --recursive - -U, --user=STRING - -w, --workgroup=STRING - -n, --nonprompt - -d, --debuglevel=INT + --recursive -D, --dots -o, --outputfile - -f, --rcfile -q, --quiet -v, --verbose -b, --blocksize @@ -36,8 +31,34 @@ -u, --update -e, --encrypt --limit-rate=INT - -?, --help + -?|--help --usage + -d|--debuglevel=DEBUGLEVEL + --debug-stdout + -s|--configfile=CONFIGFILE + --option=name=value + -l|--log-basename=LOGFILEBASE + --leak-report + --leak-report-full + -R|--name-resolve=NAME-RESOLVE-ORDER + -O|--socket-options=SOCKETOPTIONS + -m|--max-protocol=MAXPROTOCOL + -n|--netbiosname=NETBIOSNAME + --netbios-scope=SCOPE + -W|--workgroup=WORKGROUP + --realm=REALM + -U|--user=[DOMAIN/]USERNAME%[PASSWORD] + -N|--no-pass + --password=STRING + --pw-nt-hash + -A|--authentication-file=FILE + -P|--machine-pass + --simple-bind-dn=DN + --use-kerberos=desired|required|off + --use-krb5-ccache=CCACHE + --use-winbind-ccache + --client-protection=sign|encrypt|off + -V|--version smb://host/share/path/to/file smb://url2/ ... @@ -50,7 +71,7 @@ This tool is part of the samba 7 suite. - 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. + 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. @@ -73,30 +94,10 @@ - -R, --recursive + --recursive Recursively download files - - -U, --user=username[%password] - Username (and password) to use - - - - -w, --workgroup=STRING - Workgroup to use (optional) - - - - -n, --nonprompt - Don't ask anything (non-interactive) - - - - -d, --debuglevel=INT - Debuglevel to use - - -D, --dots Show dots as progress indication @@ -108,15 +109,10 @@ - -O, --stdout + --stdout Write the file that is being downloaded to standard output. - - -f, --rcfile - 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 overridden by the contents of the rcfile. - - -q, --quiet Be quiet @@ -132,16 +128,6 @@ Number of bytes to download in a block. Defaults to 64000. - - -?, --help - Show help message - - - - --usage - Display brief usage message - - -u, --update Download only when remote file is newer than local file or local file is missing. @@ -157,6 +143,10 @@ Limit download rate by this many KB/s. + &popt.autohelp; + &cmdline.common.samba.client; + &cmdline.common.connection; + &cmdline.common.credentials; @@ -180,16 +170,16 @@ smb://name/ means, if name is a workgroup, all the se EXAMPLES - + # Recursively download 'src' directory -smbget -R smb://rhonwyn/jelmer/src +smbget --recursive smb://rhonwyn/jelmer/src # Download FreeBSD ISO and enable resuming -smbget -r smb://rhonwyn/isos/FreeBSD5.1.iso +smbget --resume smb://rhonwyn/isos/FreeBSD5.1.iso # Recursively download all ISOs -smbget -Rr smb://rhonwyn/isos +smbget --recursive --resume smb://rhonwyn/isos # Backup my data on rhonwyn -smbget -Rr smb://rhonwyn/ +smbget --recursive -resume smb://rhonwyn/ @@ -197,8 +187,8 @@ smbget -Rr smb://rhonwyn/ BUGS - 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 + 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 --resursive turned on). @@ -211,10 +201,10 @@ turned on). AUTHOR - - The original Samba software and related utilities + + 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 + by the Samba Team as an Open Source project similar to the way the Linux kernel is developed. The smbget manpage was written by Jelmer Vernooij. -- 2.34.1