Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for ncpmount (redhat section 8)

NCPMOUNT(8)				     ncpmount				      NCPMOUNT(8)

NAME
       ncpmount, mount.ncp - 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 Fileserver under the speci-
       fied mount point.

       ncpfs  is a linux filesystem which understands the NCP protocol. This is the protocol Nov-
       ell 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  infor-
       mation.	Please	note  that  the access permissions 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 disables 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  configured.   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 currently unused)

       pass-fd=fd (only mount option)
	  If you want to pass password in secure way to ncpmount, you can pass it through  speci-
	  fied 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= arguments 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 fileserver. 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  direc-
	  tory.

	  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 directory, but to allow the
	  lp daemon to print on NetWare queues. This is possible  because  only  users	who  have
	  write  permissions  on a directory may issue ncp requests over a connection. The excep-
	  tion 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 certainly 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 Net-
	  Ware 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 direc-
	  tories.  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 connection.

       -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 unsta-
	  ble 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 connections 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
	  iso-8859-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).  codepage is codepage name, for example cp437.

       -b (mount option bindery)
	  If  you  are	connecting to NetWare 4 or NetWare 5 through bindery emulation 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 com-
	  mand 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 volumes. If you do not
	  want to use NFS or LONG namespace (because of bugs in (server)  code	or  for  backward
	  compatibility), you must specify 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 interface version 2. This interface was used
	  in 2.0.x kernels, does not support NCP/UDP, does not have NDS authentication info stor-
	  age 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 interface 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 authentica-
	  tion 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 interface version 4. This interface is used
	  in kernels after 2.3.40. This interface supports NCP/UDP, does have NDS  authentication
	  info storage and uses 32bit uid/gid.

       -s (mount option strong)
	  Normally,  files marked read-only cannot be removed from NetWare volume because of they
	  are marked Delete Inhibit and Rename Inhibit. If you want to remove these files by sim-
	  ple 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 nothing 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=mirror,gid=mir-
       ror,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 network 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.

       /etc/fstab
	  You must specify filesystem type ncp and not ncpfs although it is reported as ncpfs  in
	  /etc/mtab and /proc/mounts.

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-goet-
       tingen.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)


All times are GMT -4. The time now is 12:46 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password