docs/manpages/smbmnt.8

   1 .TH SMBMNT 8 "31 Aug 1998" "smbmnt 2.0.0-alpha1"
   2 .SH NAME
   3 smbmnt \- mount smb file system
   4 .SH SYNOPSIS
   5 .B smbmnt
   6 .B mount-point
   7 [
   8 .B -u
   9 .I uid
  10 ] [
  11 .B -g
  12 .I gid
  13 ] [
  14 .B -f
  15 .I file mode
  16 ] [
  17 .B -d
  18 .I dir mode
  19 ]
  20
  21 .SH DESCRIPTION
  22 .B smbmnt
  23 is a helper application used by the
  24 .BI smbmount (8)
  25 program to do the actual mounting.
  26 .B smbmnt
  27 is meant to be installed setuid root so that normal users can mount
  28 their smb shares. It checks whether the user has write permissions
  29 on the mount point and then mounts the directory.
  30
  31 The
  32 .B smbmnt
  33 program is normally invoked by a mount command to
  34 .BI smbmount ,
  35 and the command line arguments are passed directly to
  36 .B smbmnt.
  37
  38 .SH OPTIONS
  39 .B -u
  40 .I uid,
  41 .B -g
  42 .I gid
  43 .RS 3
  44 A Lan Manager server does not tell us anything about the owner of a
  45 file, but Unix requires that each file have an owner and a group it belongs
  46 to. With
  47 .B -u
  48 and
  49 .B -g
  50 you can tell smbmount which id's it should assign to the files in the
  51 mounted directory.
  52
  53 The defaults for these values are the current uid and gid.
  54 .RE
  55
  56 .B -f
  57 .I file mode,
  58 .B -d
  59 .I dir mode
  60 .RS 3
  61 Like
  62 .B -u
  63 and
  64 .B -g,
  65 these options are also used to bridge differences in concepts between
  66 Lan Manager and Unix. Lan Manager does not know anything about file
  67 permissions, so
  68 .B smbmnt
  69 must be told which permissions it should assign to the mounted files
  70 and directories.
  71
  72 The values must be given as octal numbers. The default values are taken
  73 from the current umask, where the file mode is the current umask,
  74 and the dir mode adds execute permissions where the file mode gives
  75 read permissions.
  76
  77 Note that these permissions can differ from the rights the server
  78 gives to us. If you do not have write permissions on the server,
  79 you should choose a file mode that matches your actual permissions.
  80 This certainly cannot override the restrictions imposed by the server.
  81
  82 In addition to specifying the file mode, the
  83 .B -f
  84 argument can be used to specify certain bug-fix workarounds.
  85 This allows bug fixes to be enabled on a per mount-point basis,
  86 rather than being compiled into the kernel.
  87 The required bug fixes are specified by prepending an (octal) value
  88 to the file mode.
  89 For information on the available bug workarounds, refer to the
  90 .B smbfs.txt
  91 file in the Linux kernel Documentation directory.
  92 .RE
  93
  94 .SH SEE ALSO
  95 .B smbmount(8)
  96