NAME

smbutil — interface to the SMB requester

SYNOPSIS

DESCRIPTION

The smbutil command is used to control SMB requester and issue various commands.

There are two types of options — global and local to the specified command.

Global options are as follows:

-h

Print a short help message.

-v

Verbose output.

The commands and local options are:

help command

Print usage information about command.

lookup [-w host] [-t node_type] [-e] name

Resolve the given name to an IP address. The NetBIOS name server can be directly specified via the -w option. The NetBIOS name type can be specified via the -t, the default is to lookup file servers. For a complete list of name types please see "http://support.microsoft.com/kb/163409". The NetBIOS names will be unpercent escaped out if the -e option is specified.

status [-ae] hostname

Resolve given hostname (IP address or DNS name) to NetBIOS workgroup and system name. All NetBIOS names will be displayed if the -a option is specified. All NetBIOS names will be percent escaped out if the -e option is specified.

view [-options] //[domain;][user[:password]@]server

List resources available on the specified server for the user.

The options are as follows:

-A

authorize only.

-N

don't prompt for a password.

-G

allow guest access.

-g

authorize with guest only.

-a

authorize with anonymous only.

-f

don't share session.

identity [-N] //[domain;][user[:password]@]server

Display the user's identity as known by the server for the authenticated session. Will not prompt for a password if the -N option is specified.

dfs smb://[domain;][user[:password]@]server/DfsRoot[/DfsLink]

Display the Dfs referrals for this URL for the authenticated session.

statshares [-m mount_path | -a] [-f format]

If -m is specified, it prints the attributes of the share mounted at mount_path. If -a is specified, it prints the attributes of all mounted shares. You can not specify both -m and -a together since they are mutually exclusive. -f controls the output format. If -f is not specified then human readable format is used. Supported formats are: Json.

multichannel [-m mount_path | -a] [-options] [-f format]

If -m is specified, it prints the multichannel attributes of the share mounted at mount_path. If -a is specified, it prints the multichannel attributes of all mounted shares. You can not specify both -m and -a together since they are mutually exclusive. -f controls the output format. If -f is not specified then human readable format is used. Supported formats are: Json.

The options are as follows:

-i

print information about the session.

-c

print information about the client's interfaces.

-s

print information about the server's interfaces.

-x

print information about the established connection.

If no option is given, then all options will be shown.

snapshot [-m mount_path | -a] [-f format]

If -m is specified, it prints out a list of snapshots for the item at the path of mount_path. If -a is specified, it prints the snapshots of all mounted shares. You can not specify both -m and -a together since they are mutually exclusive. -f controls the output format. If -f is not specified then human readable format is used. Supported formats are: Json.

smbstat [-f format] path_to_item

List out various information about the file or dir located at path_to_item. If -f is not specified then human readable format is used. Supported formats are: Json.

FILES

nsmb.conf

Keeps static parameters for connections and other information. See man nsmb.conf for details.

AUTHORS

Boris Popov ⟨bp@butya.kz⟩, ⟨bp@FreeBSD.org⟩

BUGS

Please report any bugs to Apple.