Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NCPMOUNT(8)			   ncpmount			   NCPMOUNT(8)

NAME
       ncpmount,  mount.ncp  -	mount volume(s)	from a specified NetWare file-
       server.

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 in-
       teresting 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 ap-
	  propriate 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  af-
       ter /)
	  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 in-
	  voking 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  ar-
	  gument),  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 op-
	  tion	--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 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).	 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 de-
	  fault.

       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.

       /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-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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | DIAGNOSTICS | EXAMPLES | NOTES | SEE ALSO | CREDITS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ncpmount&sektion=8&manpath=Red+Hat+9>

home | help