Synopsis
smbutil [-hv] command [-options] [args]
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.
macOS 26.4 February 14, 2000 macOS 26.4