added the -A <authfile> option for allowing the reading of user

name and password credentials from a file.  Designed for use
when needed to passwd credentials between scripts


--jerry
(This used to be commit d8dde169e729ad5229d2bda8c9f306edb3c1239b)

1 files changed, 18 insertions, 0 deletions

diff --git a/docs/yodldocs/smbclient.1.yo b/docs/yodldocs/smbclient.1.yo
index 7f9ebbb663..fd2c11a15c 100644
--- a/docs/yodldocs/smbclient.1.yo
+++ b/docs/yodldocs/smbclient.1.yo
@@ -287,6 +287,13 @@ that this may be very insecure on some systems but on others allows
 users to script smbclient commands without having a password appear in
 the command line of a process listing.
 
+A third option is to use a credentials file which contains
+the plaintext of the username and password.  This option is
+mainly provided for scripts where the admin doesn't desire to
+pass the credentials on the command line or via environment variables.
+If this method is used, make certain that the permissions on the file
+restrict access from unwanted users.  See the bf(-A) for more details.
+
 Note: Some servers (including OS/2 and Windows for Workgroups) insist
 on an uppercase password. Lowercase or mixed case passwords may be
 rejected by these servers.
@@ -297,6 +304,17 @@ line of a running process may be seen via the tt(ps) command to be
 safe always allow smbclient to prompt for a password and type it in
 directly.
 
+label(minusA)
+dit(bf(-A <filename>)) This option allows you to specify a file from which
+to read the username and password used in the connection.  The format
+of the file is
+
+tt(username = <value>) nl()
+tt(password = <value>) nl()
+
+Make certain that the permissions on the file restrict access from
+unwanted users.
+
 label(minusL)
 dit(bf(-L)) This option allows you to look at what services are
 available on a server. You use it as tt("smbclient -L host") and a