smbmount man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



SMBMOUNT(8)					      SMBMOUNT(8)

NAME
       smbmount - mount an smbfs filesystem

SYNOPSIS
       smbumount service mount-point [ -o options ]

DESCRIPTION
       smbmount mounts a SMB filesystem. It is usually invoked as
       mount.smb from the mount(8) command  when  using	 the  "-t
       smb" option. The kernel must support the smbfs filesystem.

       Options to smbmount are	specified  as  a  comma-separated
       list  of	 key=value  pairs. It is possible to send options
       other than those listed here, assuming that smbfs supports
       them. If you get mount failures, check your kernel log for
       errors on unknown options.

       smbmount is a daemon.  After  mounting  it  keeps  running
       until  the  mounted  smbfs is umounted. It will log things
       that happen when in daemon mode using the  "machine  name"
       smbmount, so typically this output will end up in log.smb-
       mount.  The  smbmount   process	 may   also   be   called
       mount.smbfs.

       NOTE: smbmount calls smbmnt(8) to do the actual mount. You
       must make sure that smbmnt is in the path so that  it  can
       be found.

OPTIONS
       username=<arg>
	      specifies	 the  username	to connect as. If this is
	      not given, then the environment variable	 USER  is
	      used.   This   option   can   also  take	the  form
	      "user%password" or "user/workgroup" or  "user/work-
	      group%password" to allow the password and workgroup
	      to be specified as part of the username.

       password=<arg>
	      specifies the SMB password. If this option  is  not
	      given then the environment variable PASSWD is used.
	      If it can find no password smbmount will prompt for
	      a passeword, unless the guest option is given.

	      Note  that  password  which  contain  the arguement
	      delimiter character (i.e. a comma ',') will  failed
	      to  be  parsed  correctly on the command line. How-
	      ever, the same password defined in the PASSWD envi-
	      ronment  variable or a credentials file (see below)
	      will be read correctly.

       credentials=<filename>
	      specifies a file that contains  a	 username  and/or
	      password. The format of the file is:

			   09 July 2001				1

SMBMOUNT(8)					      SMBMOUNT(8)

			username = <value>
			password = <value>

	      This  is	preferred over having passwords in plain-
	      text in a shared file, such as /etc/fstab. Be  sure
	      to protect any credentials file properly.

       netbiosname=<arg>
	      sets  the	 source	 NetBIOS name. It defaults to the
	      local hostname.

       uid=<arg>
	      sets the uid that will own all files on the mounted
	      filesystem.   It may be specified as either a user-
	      name or a numeric uid.

       gid=<arg>
	      sets the gid that will own all files on the mounted
	      filesystem.  It may be specified as either a group-
	      name or a numeric gid.

       port=<arg>
	      sets the remote SMB port	number.	 The  default  is
	      139.

       fmask=<arg>
	      sets the file mask. This determines the permissions
	      that remote files have  in  the  local  filesystem.
	      The default is based on the current umask.

       dmask=<arg>
	      sets  the	 directory mask. This determines the per-
	      missions that remote directories have in the  local
	      filesystem.   The	 default  is based on the current
	      umask.

       debug=<arg>
	      sets the debug level. This is useful  for	 tracking
	      down SMB connection problems.

       ip=<arg>
	      sets the destination host or IP address.

       workgroup=<arg>
	      sets the workgroup on the destination

       sockopt=<arg>
	      sets  the	 TCP  socket  options.	See  the smb.conf
	      socket options option.

       scope=<arg>
	      sets the NetBIOS scope

			   09 July 2001				2

SMBMOUNT(8)					      SMBMOUNT(8)

       guest  don't prompt for a password

       ro     mount read-only

       rw     mount read-write

       iocharset=<arg>
	      sets the charset used by the Linux side  for  code-
	      page to charset translations (NLS). Argument should
	      be the name of a charset,	 like  iso8859-1.  (Note:
	      only kernel 2.4.0 or later)

       codepage=<arg>
	      sets   the   codepage  the  server  uses.	 See  the
	      iocharset option. Example value cp850. (Note:  only
	      kernel 2.4.0 or later)

       ttl=<arg>
	      how long a directory listing is cached in millisec-
	      onds (also affects visibility of file size and date
	      changes).	 A higher value means that changes on the
	      server take longer to be noticed but  it	can  give
	      better performance on large directories, especially
	      over long distances. Default is  1000ms  but  some-
	      thing  like  10000ms  (10 seconds) is probably more
	      reasonable in many cases.	 (Note: only kernel 2.4.2
	      or later)

ENVIRONMENT VARIABLES
       The  variable  USER may contain the username of the person
       using the client. This information is  used  only  if  the
       protocol	 level	is  high  enough to support session-level
       passwords. The variable can be used to set  both	 username
       and password by using the format username%password.

       The variable PASSWD may contain the password of the person
       using the client. This information is  used  only  if  the
       protocol	 level	is  high  enough to support session-level
       passwords.

       The variable PASSWD_FILE may contain  the  pathname  of	a
       file  to read the password from. A single line of input is
       read and used as the password.

BUGS
       Not many known smbmount bugs. But one smbfs bug is  impor-
       tant enough to mention here anyway:

       o Mounts sometimes stop working. This is usually caused by
	 smbmount terminating.	Since  smbfs  needs  smbmount  to
	 reconnect when the server disconnects, the mount will go
	 dead. A re-mount normally fixes this. At least 2 ways to
	 trigger this bug are known.

			   09 July 2001				3

SMBMOUNT(8)					      SMBMOUNT(8)

       Note  that the typical response to a bug report is sugges-
       tion to try the latest version first. So please try  doing
       that  first,  and always include which versions you use of
       relevant software when  reporting  bugs	(minimum:  samba,
       kernel, distribution)

SEE ALSO
       Documentation/filesystems/smbfs.txt  in	the kernel source
       tree may contain additional options and information.

AUTHOR
       Volker Lendecke, Andrew Tridgell, Michael H. Warfield  and
       others.

       The  current  maintainer	 of smbfs and the userspace tools
       smbmount,  smbumount,  and   smbmnt   is	  Urban	  Widmark
       <URL:mailto:urban@teststation.com>.    The  SAMBA  Mailing
       list <URL:mailto:samba@samba.org> is the	 preferred  place
       to ask questions regarding these programs.

       The conversion of this manpage for Samba 2.2 was performed
       by Gerald Carter

			   09 July 2001				4

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net