te
Copyright (c) 2009, Sun Microsystems, Inc. All Right Reserved.
Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
smbutil - Solaris CIFS client utility

/usr/bin/smbutil crypt

/usr/bin/smbutil login [-c] [[domain/]user]

/usr/bin/smbutil login [-c] [user[@domain]]

/usr/bin/smbutil logout [[domain/]user]

/usr/bin/smbutil logout [user[@domain]]

/usr/bin/smbutil logout -a

/usr/bin/smbutil logoutall

/usr/bin/smbutil lookup name

/usr/bin/smbutil status server

/usr/bin/smbutil view [-A | -U user] //[domain;][user[:password]@]server

/usr/bin/smbutil [-?dv]

The smbutil command controls the Solaris CIFS client and issues various commands.

The smbutil command supports the following subcommands:

crypt

login [-c] [ [[domain/]user] | [user[@domain] ]

logout [ [[domain/]user] | [user[@domain] ]

logout -a

logoutall

lookup name

status server

view [-A | -U user] //[domain;][user[:password]@]server

The following global options are supported:

-d

-v

-?

Example 1 Creating a Password Hash for the $HOME/.nsmbrc File

The following example shows how to use the smbutil crypt command to create a hash of the password you specify. Then, you can use the hash as the value for the $HOME/.nsmbrc file.

Be sure to escape the two dollar-sign prefix of the hashed password if you store it as a value of the password property.

$ smbutil crypt
Password:
$$178465324253e0c07

The following $HOME/.nsmbrc file fragment shows how the password hash value is set:

[RSERVER:george]
charsets=koi8-r:cp866
password='$$178465324253e0c07'

Example 2 Storing a Password for a CIFS Server

The following example shows how to use the smbutil login command to store the root@example user's password.

$ smbutil login root@example
Password:

Example 3 Erasing the Stored Password

The following example shows how to use the smbutil logout command to remove the root@example user's password.

$ smbutil logout root@example

Example 4 Viewing Available Shares

The following example shows how to use the smbutil view command to see the available shares for user root on server example.

$ smbutil view //root@example
Password:
Share Type Comment
-------------------------------
netlogon disk Network Logon Service
ipc$ IPC IPC Service (Samba Server)
tmp disk Temporary file space
public disk Public Stuff
root disk Home Directories

5 shares listed from 5 available

Example 5 Viewing Available Shares as an Anonymous User

The following example shows how to use the smbutil view command to anonymously view the available shares on the example server.

$ smbutil view -A //example
Share Type Comment
-------------------------------
netlogon disk Network Logon Service
ipc$ IPC IPC Service (Samba Server)
tmp disk Temporary file space
public disk Public Stuff
ethereal disk /export/ethereal
myshare disk Jan's stuff

6 shares listed from 6 available

Example 6 Obtaining the IP Address From a Server Name

The following example shows how to use the smbutil lookup command to obtain the IP address of the example server.

$ smbutil lookup example
Got response from 192.168.168.210
IP address of example: 192.168.168.210

Example 7 Obtaining the NetBIOS Domain and System Name Using the Server Name

The following example shows how to use the smbutil status command to obtain the NetBIOS domain and system name of the example server. The server name, example, is specified on the command line.

$ smbutil status example
Domain: WORKGROUP
Server: EXAMPLE

Example 8 Obtaining the NetBIOS Domain and System Name Using the IP Address

The following example shows how to use the smbutil status command to obtain the NetBIOS domain and system name of the example server. The IP address, 192.168.168.210, is specified on the command line.

$ smbutil status 192.168.168.210
Domain: WORKGROUP
Server: EXAMPLE

$HOME/.nsmbrc

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	See below.

The output is Uncommitted. The rest of the interface is Committed.

mount_smbfs(1M), nsmbrc(4), attributes(5), smbfs(7FS)

This manual page contains material originally authored by Boris Popov, bp@butya.kz, bp@FreeBSD.org.

The Solaris CIFS client always attempts to use gethostbyname() to resolve host names. If the host name cannot be resolved, the CIFS client uses NetBIOS name resolution (NBNS). By default, the Solaris CIFS client permits the use of NBNS to enable Solaris CIFS clients in Windows environments to work without additional configuration.

Since NBNS has been exploited in the past, you might want to disable it. To disable NBNS, set the nbns-enabled service management facility property to false. By default, nbns-enabled is set to true.