Hi,

The attached patch adds documentation of the .netrc file support to the
manpage. This patch will already be included in the 0.22.4 Debian package to
close bug #397735 (http://bugs.debian.org/397735).

Is this fine for inclusion in the official release?

Cheers,
Sebastian

-- 
Sebastian "tokkee" Harl
GnuPG-ID: 0x8501C7FC
http://tokkee.org/

--- a/doc/cadaver.1     2007-01-08 15:32:18.000000000 +0100
+++ b/doc/cadaver.1     2007-01-08 15:32:13.000000000 +0100
@@ -14,6 +14,12 @@
 .BR smbclient (1). 
 A user familiar with these tools should be quite
 comfortable with cadaver.
+
+.B cadaver
+supports automatically logging in to servers requiring authentication via
+a .netrc file (similar to
+.BR ftp (1)
+- see section "THE .netrc FILE" below).
 .SH OPTIONS
 .IP "-e, --expect100"
 Enable sending of `Expect: 100-continue' header.
@@ -93,6 +99,55 @@
 Logout of authentication session
 .IP "help [command]"
 Display help message
+.SH THE .netrc FILE
+The file
+.I ~/.netrc
+may be used to automatically login to a server requiring authentication. The
+following tokens (separated by spaces, tabs or newlines) may be used:
+
+.B machine
+.I host
+.RS
+Identify a remote machine
+.I host
+which is compared with the hostname given on the command line or as an
+argument to the
+.B open
+command.
+Any subsequent tokens up to the end of file or the next
+.B machine
+or
+.B default
+token are associated with this entry.
+.RE
+
+.B default
+.RS
+This is equivalent to the
+.B machine
+token but matches any hostname. Only one
+.B default
+token may be used and it must be after all
+.B machine
+tokens.
+.RE
+
+.B login
+.I username
+.RS
+Specifies the username to use when logging in to the remote machine.
+.RE
+
+.B password
+.I string
+.br
+.B passwd
+.I string
+.RS
+Specifies the password to use when logging in to the remote machine.
+.RE
+
+Any other tokens (as described in ftp(1)) are ignored.
 .SH EXAMPLES
 .IP "cadaver http://dav.example.com/";
 Connects to the server myserver.example.com, opening the root collection.
@@ -105,6 +160,9 @@
 .SH FILES
 .IP "~/.cadaverrc"
 Individual user settings that can override cadaver defaults.
+.IP "~/.netrc"
+Login and initialization information used by the auto-login process. See
+section "THE .netrc FILE" for details.
 .SH AUTHOR
 Joe Orton <[email protected]>
 .SH SEE ALSO

Attachment: signature.asc
Description: Digital signature

_______________________________________________
cadaver mailing list
[email protected]
http://mailman.webdav.org/mailman/listinfo/cadaver

Reply via email to