Mac Developer Library Developer


This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.

MOUNT_SMBFS(8)            BSD System Manager's Manual           MOUNT_SMBFS(8)

     mount_smbfs -- mount a shared resource from an SMB file server

     mount_smbfs [-N] [-o options] [-d mode] [-f mode] [-h] //[domain;][user[:password]@]server[/share] path

     The mount_smbfs command mounts a share from a remote server using SMB/CIFS protocol.

     The options are as follows:

     -N      Do not ask for a password.  At run time, mount_smbfs reads the ~/Library/Preferences/nsmb.conf
             file for additional configuration parameters and a password.  If no password is found,
             mount_smbfs prompts for it.

     -o      Options passed to mount(2) are specified with the -o option followed by a comma separated
             string of options. See the mount(8) man page for possible options and their meanings. Addi-tional Additional
             tional options supported by the mount_smbfs are as follows:

                     Indicate to the Carbon subsystem that this volume is not to be displayed to the user.

                     Set flags on the mountpoint to indicate that the volume has been mounted by the auto-mounter. automounter.

                     Don't use NTFS Streams even if they are supported by the server.

             soft    Make the mount soft.  Fail file system calls after a number of seconds.

                     Turn off using notifications for this volume.

     -f mode, -d mode
             Specify permissions that should be assigned to files and directories.  The values must be spec-ified specified
             ified as octal numbers.  Default value for the file mode is taken from mount point, default
             value for the directory mode adds execute permission where the file mode gives read permission.

             Note that these permissions can differ from the rights granted by SMB server.

     -h      Prints a help message, much like the SYNOPSIS above.

     //[domain;][user[password]@] server[/share]
             The mount_smbfs command will use server as the NetBIOS name of remote computer, user as the
             remote user name and share as the resource name on a remote server.  Domain and/or password may
             be specified here.  If user is omitted the logged in user id will be used.  Omitting share is
             an error when mount_smbfs is run from the command line, otherwise a browsing dialogue is pre-sented. presented.

     path    Path to mount point.

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

     This example shows the proper url to use to mount the share PUBLIC from the SMB server myserver :

           mkdir /smb/public
           mount -t smbfs //username:userpass@myserver/PUBLIC /smb/public

     This example shows the proper url to use to mount the share PUBLIC from the SMB server myserver as

           mkdir /smb/public
           mount -t smbfs //guest:@myserver/PUBLIC /smb/public
     Note: You should always use the system mount command and never call mount_smbfs directly.

     mount(2), nsmb.conf(5), mount(8), umount(8)

     Please report bugs to Apple.

     Boris Popov <>, <>

FreeBSD                         March 10, 2000                         FreeBSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.