ncpmount man page on Knoppix

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

NCPMOUNT(8)			   ncpmount			   NCPMOUNT(8)

NAME
       ncpmount,  mount.ncp,  mount.ncpfs  -  mount volume(s) from a specified
       NetWare fileserver.

SYNOPSIS
       ncpmount [ -h ] [ -S server ] [ -U user name ] [ -P password | -n  ]  [
       -C ] [ -c client name ] [ -u uid ] [ -g gid ] [ -f file mode ] [ -d dir
       mode ] [ -V volume ] [ -t time_out ] [ -r retry_count ] [  -b  ]	 [  -i
       level  ]	 [  -v	] [ -m ] [ -y iocharset ] [ -p codepage ] [ -N ignored
       namespace ] [ -2 | -3 | -4 ] [ -s ] [ -A dns name ] mount-point

       mount.ncp remote-server-and-user mount-point  [	-n  ]  [  -v  ]	 [  -o
       mount_options ]

DESCRIPTION
       This  program  is  used to mount volumes of the specified NetWare File‐
       server under the specified mount point.

       ncpfs is a linux filesystem which understands the NCP protocol. This is
       the  protocol  Novell  NetWare  clients use to talk to NetWare servers.
       ncpfs was inspired by lwared, a free NetWare emulator for Linux written
       by  Ales	 Dryak.	 See  ftp://klokan.sh.cvut.cz/pub/linux	 for this very
       interesting program.

       ncpmount, when invoked with all	appropriate  arguments,	 attaches  and
       logs  into  specified  server  and mounts all volumes (or one volume or
       subtree) from server under the specified mount  point.	ncpmount  when
       invoked	without	 any  arguments specifying the fileserver, user id and
       password checks the file $HOME/.nwclient to find a file server, a  user
       name  and possibly a password to use for the specified mount point. See
       nwclient(5) for more information. Please note that the  access  permis‐
       sions of .nwclient MUST be 600, for security reasons.

OPTIONS
       mount-point
	  mount-point  is the directory you want to mount the filesystem over.
	  Its function is the the same as for a normal mount command.

	  If the real uid of the caller is not root, ncpmount  checks  whether
	  the  user is allowed to mount a filesystem on the mount-point. So it
	  should be safe to make ncpmount setuid root. The  filesystem	stores
	  the  uid  of	the  user  who called ncpmount. So ncpumount can check
	  whether the caller is allowed to unmount the filesystem.

       -S server (mount option server= or part before / in  remote-server-and-
       user)
	  server is the name of the server you want to use.

       -h
	  -h is used to print out a short help text.

       -C (mount option noupcasepasswd)
	  By default passwords are converted to uppercase before they are sent
	  to the server because most servers require this.  This  option  dis‐
	  ables this feature ensuring that passwords are sent without any case
	  conversion.

       -n (mount option nopasswd)
	  -n must be specified for logins that do not have a password  config‐
	  ured.	  This option means do not update /etc/mtab if there is option
	  -o on command line. You must use -o nopasswd in this case.

       passwdfile=file (only mount option)
	  If you want specify password and you do not want store it into world
	  readable  /etc/fstab,	 you  can use this option.  file then contains
	  lines in form SERVER/USER:PASSWORD:other_data (other_data  are  cur‐
	  rently unused)

       pass-fd=fd (only mount option)
	  If you want to pass password in secure way to ncpmount, you can pass
	  it through specified fd.

       -P password (mount option passwd=)
	  specifies the password to use for the Netware user id.

	  If neither -n nor the -P nor the passwdfile= nor the pass-fd=	 argu‐
	  ments	 are specified ncpmount will prompt for a password. This makes
	  it difficult to use in scripts such as /etc/rc. If you want to  have
	  ncpmount  work  automatically	 from  a  script  you must include the
	  appropriate option and be very careful  to  ensure  that  appopriate
	  file	permissions are set for the script that includes your password
	  to ensure that others can not read it.

       -U user name (mount option  user=  or  rest  of	remote-server-and-user
       after /)
	  Specifies  the  Netware  user id to use when logging in to the file‐
	  server. If this option is not specified then ncpmount	 will  attempt
	  to  login  to	 the  fileserver  using the Linux login id of the user
	  invoking ncpmount.

       -m (mount option multiple)
	  Normally, ncpmount limits  number  of	 connections  from  client  to
	  server  to one per unique user name. If you want mount more than one
	  connection with same username and server, you must specify -m.

       -u uid, -g gid (mount option uid= and gid=)
	  ncpmount does	 not  yet  implement  a	 scheme	 for  mapping  NetWare
	  users/groups	to  Linux  users/groups. Linux requires that each file
	  has an owner and group id.  With -u and -g  you  can	tell  ncpmount
	  which id's it should assign to the files in the mounted directory.

	  The defaults for these values are the current uid and gid.

       -c user name (mount option owner=)
	  -c  names  the  user who is the owner of the connection, where owner
	  does not refer to file ownership (that "owner"  is  set  by  the  -u
	  argument),  but  the	owner of the mount, ie: who is allowed to call
	  ncpumount on this mount. The default owner of the connection and the
	  mount	 is  the  user	who called ncpmount. This option allows you to
	  specify that some other user should be set as the owner.

	  In this this way it is possible to mount a public  read-only	direc‐
	  tory, but to allow the lp daemon to print on NetWare queues. This is
	  possible because only users who have write permissions on  a	direc‐
	  tory may issue ncp requests over a connection. The exception to this
	  rule is the 'mount owner', who is also granted 'request permission'.

       -f file mode, -d dir  mode  (mount  option  mode=  (or  filemode=)  and
       dirmode=)
	  Like -u and -g, these options are used to determine what permissions
	  should be assigned files and directories of the mounted volumes. The
	  values  must	be  specified as octal numbers. The default values are
	  taken from the current umask, where the file	mode  is  the  current
	  umask, and the dir mode adds execute permissions where the file mode
	  gives read permissions.

	  Note that these permissions can differ from the  rights  the	server
	  gives to us. If you do not have write permissions on the server, you
	  can very well choose a file mode that tells that you have. This cer‐
	  tainly cannot override the restrictions imposed by the server.

       -V volume (mount option volume=)
	  There	 are  2	 general  ways	you  can mount a NetWare server's disk
	  space: Either you can mount all volumes under one directory, or  you
	  can mount only a single volume.

	  When	you  choose to mount the complete disk space at once, you have
	  the advantage that only one Linux mount point and only  one  NetWare
	  connection is used for all the volumes of this server. Both of these
	  are limited resources. (Although raising the number of  Linux	 mount
	  points is significantly cheaper than raising the number of available
	  NetWare connections ;-))

	  When you specify to mount a single volume by	using  the  option  -V
	  volume,  you	have  the big advantage that nfsd is able to re-export
	  this mounted directory. You must invoke nfsd	and  mountd  with  the
	  option --re-export to make nfsd re-export ncpfs mounted directories.
	  This uses one Linux mount  point  and	 one  NetWare  connection  per
	  mounted volume. Maybe sometime in the future I will make it possible
	  to mount all volumes on different mount points, using only one  con‐
	  nection.

       -t time_out (mount option timeo= or timeout=)
	  With -t you can adjust the time ncpfs waits for the server to answer
	  a request it sent. Use the option to raise the  timeout  value  when
	  your ncpfs connections seem to be unstable although your servers are
	  well up. This can happen when you have very busy servers, or servers
	  that are very far away.

	  time_out is specified in 1/100s, the current default value is 60.

       -r retry_count (mount option retry=)
	  As  -t,  -r  can be used to tune the ncpfs connection to the server.
	  With retry_count you can specify how many times ncpfs	 will  attempt
	  to  send  a packet to the server before it decides the connection is
	  dead. The current default value is 5.

	  Currently ncpfs is not too clever when trying to find out that  con‐
	  nections  are dead. If anybody knows how to do that correctly, as it
	  is done by commercial workstations, please tell me.

       -y iocharset (mount option iocharset=)
	  You can specify character translation	 rules	for  converting	 names
	  from unicode to your desktop (it works together with -p).  iocharset
	  is charset name, for example iso8859-1.

       -p codepage (mount option codepage=)
	  You can specify character translation	 rules	for  converting	 names
	  from Netware encoding to unicode (it works together with -y).	 code‐
	  page is codepage name, for example cp437.

       -b (mount option bindery)
	  If you are connecting to NetWare 4 or NetWare 5 through bindery emu‐
	  lation instead of NDS, you must specify this option.

       -i level (mount option signature=level)
	  Enables  packet  signing.  level  is from 0 to 3: 0 means disable, 1
	  means sign if server needs it, 2 means sign if server allows it  and
	  3 means sign packets always.

       -v
	  Print	 ncpfs version number. It has another meaning (verbose) if you
	  specify -o on command line. If you are interested in	version,  type
	  ncpmount -v without another options.

       -A dns name (mount option ipserver=dns name)
	  When	you  are  mounting volumes from NetWare 5 server over UDP, you
	  must specify dns name of server here and logical server name	in  -S
	  (or  in server=). This name is used to switch ncpmount into UDP mode
	  and to specify server to connect. Currently, DNS is  only  supported
	  IP name resolution protocol. There is currently no support for SLP.

       -N ignored namespace (mount option nonfs and nolong)
	  ncpfs	 supports  NFS,	 LONG (OS/2) and DOS namespace on NetWare vol‐
	  umes. If you do not want to use NFS or LONG  namespace  (because  of
	  bugs in (server) code or for backward compatibility), you must spec‐
	  ify these ignored namespaces in mount parameters.

       -2
	  If you have unusual ncpfs code in kernel and ncpmount is not able to
	  autodetect it, use this option. It switches ncpmount to ncpfs inter‐
	  face version 2. This interface was used in 2.0.x kernels,  does  not
	  support  NCP/UDP,  does not have NDS authentication info storage and
	  uses only 16bit uid/gid.

       -3
	  If you have unusual ncpfs code in kernel and ncpmount is not able to
	  autodetect it, use this option. It switches ncpmount to ncpfs inter‐
	  face version 3. This interface was used in kernels  from  2.1.30  to
	  2.3.40 (laters 2.3.x and 2.4.x still supports this interface to make
	  transition easier). This interface supports NCP/UDP, does  have  NDS
	  authentication  info storage (if you uncomment it in kernel sources)
	  and uses 16bit uid/gid.

       -4
	  If you have unusual ncpfs code in kernel and ncpmount is not able to
	  autodetect it, use this option. It switches ncpmount to ncpfs inter‐
	  face version 4. This interface is used in kernels after 2.3.40. This
	  interface  supports NCP/UDP, does have NDS authentication info stor‐
	  age and uses 32bit uid/gid.

       -s (mount option strong)
	  Normally, files marked read-only cannot be removed from NetWare vol‐
	  ume because of they are marked Delete Inhibit and Rename Inhibit. If
	  you want to remove these files by simple unlink,  you	 should	 mount
	  volume with this option.

       mount option nostrong
	  Refuse  to remove read-only files. If you want remove such file, you
	  must first remove read-only attribute. It is	standard  behavior  of
	  ncpfs.

       mount option symlinks
	  Use  special,	 normally  unused,  attributes combinations to express
	  symlinks, executable attributes and files readable by world.

       mount option nosymlinks
	  Do not allow special meaning of 'shareable'  attribute.  This	 is  a
	  default.

       mount option ipx
	  Use  IPX  for	 connection  to	 server. Default if no ipserver option
	  specified on cmdline.

       mount option udp
	  Use UDP for connection to server. Not available  in  2.0.x  kernels.
	  Default if ipserver is used.

       mount option tcp
	  Use  TCP  for	 connection  to	 server. Available only with 2.4.0 and
	  later kernels.

       mount option nfsextras
	  Use the meta-data provided by the  NFS  namespace  to	 allow	files'
	  modes to be changed, and to allow the creation of symlinks and named
	  pipes.  This adds significant overhead to fetching file information.

       mount option nonfsextras
	  Do not make use of meta-data provided by the NFS namespace.  This is
	  the default.

ENVIRONMENT VARIABLES
       USER / LOGNAME
	  The variables USER or LOGNAME may contain the username of the person
	  using the client.  USER is tried first. If it's  empty,  LOGNAME  is
	  tried.

DIAGNOSTICS
       Most  diagnostics issued by ncpfs are logged by syslogd. Normally noth‐
       ing is printed, only error situations are logged there.

EXAMPLES
       If you want to mount volume SYS as user	DOWNLOAD  from	server	MIRROR
       into  directory	/home/pub/mirror,  with	 files owner mirror.mirror and
       file mode -rw-r--r--, you can add

       MIRROR/DOWNLOAD	 /home/pub/mirror    ncp    defaults,mode=644,uid=mir‐
       ror,gid=mirror,owner=root,volume=SYS,nopasswd,multiple

       into  /etc/fstab.  You should always specify multiple in mount options,
       otherwise there can be only one connection to server with same name.

NOTES
       IPX
	  You must configure the IPX subsystem before ncpmount will work.   It
	  is  especially  important that there is a route to the internal net‐
	  work of your server.

       IP
	  You must specify both -S logical_name and -A dns_name.  logical_name
	  is  used  for	 searching .nwclient, other configuration files and is
	  logged into /etc/mtab, dns_name is used for connecting to server. In
	  future, logical_name will be read from server.

SEE ALSO
       syslogd(8), ncpumount(8), nfsd(8), mountd(8), mount(8)

CREDITS
       ncpfs  would  not  have	been  possible without lwared, written by Ales
       Dryak (A.Dryak@sh.cvut.cz).

       The encryption code was taken from Dr.  Dobbs's	Journal	 11/93.	 There
       Pawel Szczerbina described it in an article on NCP.

       The  ncpfs  code	 was  initially	 hacked	 from smbfs by Volker Lendecke
       (lendecke@math.uni-goettingen.de). smbfs was put together  by  Paal-Kr.
       Engstad (pke@engstad.ingok.hitos.no) and later polished by Volker.

       Code is currently maintained by Petr Vandrovec (vandrove@vc.cvut.cz).

ncpmount			  12/04/1998			   NCPMOUNT(8)
[top]

List of man pages available for Knoppix

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