From owner-freebsd-doc@FreeBSD.ORG Wed Mar 4 17:10:03 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B45261065673 for ; Wed, 4 Mar 2009 17:10:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 474898FC23 for ; Wed, 4 Mar 2009 17:10:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n24HA2gW070257 for ; Wed, 4 Mar 2009 17:10:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n24HA2CM070256; Wed, 4 Mar 2009 17:10:02 GMT (envelope-from gnats) Resent-Date: Wed, 4 Mar 2009 17:10:02 GMT Resent-Message-Id: <200903041710.n24HA2CM070256@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, David Horn Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 65A3E106566B for ; Wed, 4 Mar 2009 17:02:46 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 3864D8FC2E for ; Wed, 4 Mar 2009 17:02:46 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n24H2kBG041873 for ; Wed, 4 Mar 2009 17:02:46 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n24H2jEd041872; Wed, 4 Mar 2009 17:02:45 GMT (envelope-from nobody) Message-Id: <200903041702.n24H2jEd041872@www.freebsd.org> Date: Wed, 4 Mar 2009 17:02:45 GMT From: David Horn To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/132311: [patch] man5/nsmb.conf.5 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 04 Mar 2009 17:10:04 -0000 >Number: 132311 >Category: docs >Synopsis: [patch] man5/nsmb.conf.5 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Mar 04 17:10:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: David Horn >Release: 7.0 >Organization: >Environment: FreeBSD dhorn-bsd 7.0-RELEASE-p7 FreeBSD 7.0-RELEASE-p7 #0: Sun Dec 21 12:33:45 UTC 2008 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: Add some missing documentation to the man page for nsmb.conf. /usr/src/share/man/man5/nsmb.conf.5 - FILES section ref: ~/nsmb.conf - use of password in examples section - use of simple encryption for password in examples section This is a fairly trivial change, but also very useful information. nsmb.conf on HEAD also has same issue >How-To-Repeat: man 5 nsmb.conf >Fix: unified diff attached for man5/nsmb.conf.5 Patch attached with submission follows: --- nsmb.conf.5.original 2009-03-04 11:10:51.000000000 -0500 +++ nsmb.conf.5 2009-03-04 11:47:26.000000000 -0500 @@ -87,7 +87,7 @@ .It Va nbns Ta "+ + - -" Ta "address of NetBIOS name server (WINS)" .It Va nbscope Ta "+ + - -" Ta "NetBIOS scope" .It Va nbtimeout Ta "+ + - -" Ta "timeout for NetBIOS name servers" -.It Va password Ta "- - + +" Ta "plain text password used to access the given share" +.It Va password Ta "- - + +" Ta "plain text or simple encrypted password used to access the given share" .It Va retry_count Ta "+ + - -" Ta "number of retries before connection is marked as broken" .It Va timeout Ta "+ + - -" Ta "SMB request timeout" .It Va workgroup Ta "+ + + +" Ta "workgroup name" @@ -96,6 +96,9 @@ .Bl -tag -width ".Pa /etc/nsmb.conf" .It Pa /etc/nsmb.conf The default remote mount-point configuration file. +.Pa ~/nsmb.conf" +.It Pa ~/nsmb.conf +The user specific remote mount-point configuration file. .El .Sh EXAMPLES What follows is a sample configuration file which may, @@ -108,6 +111,9 @@ [FSERVER] charsets=koi8-r:cp866 addr=fserv.example.com +# User specific data for FSERVER +[FSERVER:MYUSER] +password=$$16144562c293a0314e6e1 .Ed .Pp All lines which begin with the @@ -124,6 +130,18 @@ The hostname value, .Dq Li fserv.example.com , is also assigned in this section. +.Dq Li FSERVER:USER , +defines the user specific settings, and is useful for saving the password +for a specific connection. The password may be plaintext or obfuscated +using simple encryption. +The simple encrypted password starts with the `$$1' symbols. Warning: the +encryption function is very weak and intended only to hide clear +text password. +If you wish to use simple encryption, you can +generate this using the following command: +.Bd -literal -offset indent +smbutil crypt +.Ed .Sh COMPATIBILITY At the time of this writing, the .Tn IPX >Release-Note: >Audit-Trail: >Unformatted: