nsmb.conf.5 (118699) | nsmb.conf.5 (214387) |
---|---|
1.\" Copyright (c) 2003 2.\" Originally written by Sergey A. Osokin 3.\" Rewritten by Tom Rhodes 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" | 1.\" Copyright (c) 2003 2.\" Originally written by Sergey A. Osokin 3.\" Rewritten by Tom Rhodes 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" |
26.\" $FreeBSD: head/share/man/man5/nsmb.conf.5 118699 2003-08-09 19:11:52Z trhodes $ | 26.\" $FreeBSD: head/share/man/man5/nsmb.conf.5 214387 2010-10-26 18:32:51Z bcr $ |
27.\" | 27.\" |
28.Dd June 30, 2003 | 28.Dd October 19, 2010 |
29.Dt NSMB.CONF 5 30.Os 31.Sh NAME 32.Nm nsmb.conf 33.Nd configuration file for 34.Tn SMB 35requests 36.Sh DESCRIPTION --- 45 unchanged lines hidden (view full) --- 82.Bl -column ".Va retry_count" ".Sy Section" 83.It Sy "Keyword Section Comment" 84.It Sy " A B C D" 85.It Va addr Ta "- + - -" Ta "IP or IPX address of SMB server" 86.It Va charsets Ta "- + + +" Ta "local:remote charset pair" 87.It Va nbns Ta "+ + - -" Ta "address of NetBIOS name server (WINS)" 88.It Va nbscope Ta "+ + - -" Ta "NetBIOS scope" 89.It Va nbtimeout Ta "+ + - -" Ta "timeout for NetBIOS name servers" | 29.Dt NSMB.CONF 5 30.Os 31.Sh NAME 32.Nm nsmb.conf 33.Nd configuration file for 34.Tn SMB 35requests 36.Sh DESCRIPTION --- 45 unchanged lines hidden (view full) --- 82.Bl -column ".Va retry_count" ".Sy Section" 83.It Sy "Keyword Section Comment" 84.It Sy " A B C D" 85.It Va addr Ta "- + - -" Ta "IP or IPX address of SMB server" 86.It Va charsets Ta "- + + +" Ta "local:remote charset pair" 87.It Va nbns Ta "+ + - -" Ta "address of NetBIOS name server (WINS)" 88.It Va nbscope Ta "+ + - -" Ta "NetBIOS scope" 89.It Va nbtimeout Ta "+ + - -" Ta "timeout for NetBIOS name servers" |
90.It Va password Ta "- - + +" Ta "plain text password used to access the given share" | 90.It Va password Ta "- - + +" Ta "plain text or simple encrypted password used to access the given share" |
91.It Va retry_count Ta "+ + - -" Ta "number of retries before connection is marked as broken" 92.It Va timeout Ta "+ + - -" Ta "SMB request timeout" 93.It Va workgroup Ta "+ + + +" Ta "workgroup name" 94.El 95.Sh FILES 96.Bl -tag -width ".Pa /etc/nsmb.conf" 97.It Pa /etc/nsmb.conf 98The default remote mount-point configuration file. | 91.It Va retry_count Ta "+ + - -" Ta "number of retries before connection is marked as broken" 92.It Va timeout Ta "+ + - -" Ta "SMB request timeout" 93.It Va workgroup Ta "+ + + +" Ta "workgroup name" 94.El 95.Sh FILES 96.Bl -tag -width ".Pa /etc/nsmb.conf" 97.It Pa /etc/nsmb.conf 98The default remote mount-point configuration file. |
99.Pa "~/nsmb.conf" 100.It Pa ~/nsmb.conf 101The user specific remote mount-point configuration file. |
|
99.El 100.Sh EXAMPLES 101What follows is a sample configuration file which may, 102or may not match your environment: 103.Bd -literal -offset indent 104# Configuration file for example.com 105[default] 106workgroup=SALES 107# The 'FSERVER' is an NT server. 108[FSERVER] 109charsets=koi8-r:cp866 110addr=fserv.example.com | 102.El 103.Sh EXAMPLES 104What follows is a sample configuration file which may, 105or may not match your environment: 106.Bd -literal -offset indent 107# Configuration file for example.com 108[default] 109workgroup=SALES 110# The 'FSERVER' is an NT server. 111[FSERVER] 112charsets=koi8-r:cp866 113addr=fserv.example.com |
114# User specific data for FSERVER 115[FSERVER:MYUSER] 116password=$$16144562c293a0314e6e1 |
|
111.Ed 112.Pp 113All lines which begin with the 114.Ql # 115character are comments and will not be parsed. 116The 117.Dq Li default 118section describes the default workgroup or domain, in this case 119.Dq Li SALES . 120The next section depicted here as 121.Dq Li FSERVER , 122defines a server section and then assigns it a charset which is only 123required when Cyrillic characters are not used. 124The hostname value, 125.Dq Li fserv.example.com , 126is also assigned in this section. | 117.Ed 118.Pp 119All lines which begin with the 120.Ql # 121character are comments and will not be parsed. 122The 123.Dq Li default 124section describes the default workgroup or domain, in this case 125.Dq Li SALES . 126The next section depicted here as 127.Dq Li FSERVER , 128defines a server section and then assigns it a charset which is only 129required when Cyrillic characters are not used. 130The hostname value, 131.Dq Li fserv.example.com , 132is also assigned in this section. |
133.Dq Li FSERVER:USER , 134defines the user settings and is useful for saving the password used 135during a specific connection. 136The password may be plaintext or obfuscated using simple encryption. 137The simple encrypted password starts with the `$$1' symbols. 138Warning: the encryption function is very weak and intended only to hide 139clear text passwords. 140If the use of simple encryption is desired, the following command may be 141used on a password: 142.Bd -literal -offset indent 143smbutil crypt 144.Ed |
|
127.Sh COMPATIBILITY 128At the time of this writing, the 129.Tn IPX 130protocol remains unsupported. 131Future 132.Fx 133releases are expected to support this. 134.Sh SEE ALSO 135.Xr smbutil 1 , 136.Xr mount_smbfs 8 137.Sh AUTHORS 138This manual page was written by 139.An -nosplit 140.An Sergey Osokin Aq osa@FreeBSD.org 141and 142.An Tom Rhodes Aq trhodes@FreeBSD.org . | 145.Sh COMPATIBILITY 146At the time of this writing, the 147.Tn IPX 148protocol remains unsupported. 149Future 150.Fx 151releases are expected to support this. 152.Sh SEE ALSO 153.Xr smbutil 1 , 154.Xr mount_smbfs 8 155.Sh AUTHORS 156This manual page was written by 157.An -nosplit 158.An Sergey Osokin Aq osa@FreeBSD.org 159and 160.An Tom Rhodes Aq trhodes@FreeBSD.org . |