source: basicnet/netprogs/ncpfs/ncpfs-config.xml@ 369af35a

<sect2>
<title>Configuring <application>NCPFS</application></title>

<sect3><title>Config files</title>
<para><filename>~/.nwclient</filename></para>
</sect3>

<sect3><title>Configuration Information</title>

<para>A config file <filename>~/.nwclient</filename> should be placed
in the home directory of each user that intends to use <application>ncpfs
</application>. The permissions on this file should be set to 600, for obvious 
security reasons.  The configuration file should contain a single line
per server that the user will use.  Each line should contain
the server name, the user name, and optionally the password.  Below is a
sample <filename>.nwclient</filename> file.</para>

<screen><userinput># Begin example <filename>~/.nwclient</filename> config file

Server1/User1 Password
Server2/User1 
Server2/Guest1 -

# End example .nwclient config file</userinput></screen>

<para>The syntax for the <filename>.nwclient</filename> file is simple,
<userinput>server_name/user_name password</userinput>.  Be extremely
careful when creating or editing this file as the client utilities are
very picky about syntax.  There should always be a space immediately
after the username.  If this space is substituted by a tab or multiple 
spaces, you will not get the expected results when attempting to use 
the <application>NCPFS</application> tools.  If no password is supplied, 
the client utilities will ask for a password when it is needed.  If no 
password is needed, for instance when using a guest account, a single '-' 
should be put in place of a password.</para>

<para>It should be noted that the ncpmount is not intended to mount
individual volumes because each mount point creates a separate client
connection to the Novell server.  Mounting each individual volume
separately would be unwise, as mounting all volumes on a server 
under one mount point uses only one client connection.</para>

<para>If you need to set up the <acronym>IPX</acronym> protocol at boot, 
you can create the following scripts.  These scripts assume <acronym>IPX
</acronym> will be set up on <emphasis role="strong">eth0</emphasis>  
and the network frame type is 802.2.  You should confirm that these 
are the correct settings and adjust as necessary.</para>

<screen><userinput><command>cat &gt; /etc/sysconfig/network-devices/ifup-ipx0 &lt;&lt; "EOF"</command>
#!/bin/sh
# Begin /etc/sysconfig/network-devices/ifup-ipx0

. /etc/sysconfig/rc || exit
. $rc_functions || exit

echo "Setting up the IPX protocol on eth0..."
/bin/ipx_interface add eth0 802.2 &amp;&amp;
/bin/ipx_configure --auto_interface=on --auto_primary=on
evaluate_retval

# End /etc/sysconfig/network-devices/ifup-ipx0
<command>EOF
cat &gt; /etc/sysconfig/network-devices/ifdown-ipx0 &lt;&lt; "EOF"</command>
#!/bin/sh
# Begin /etc/sysconfig/network-devices/ifdown-ipx0

. /etc/sysconfig/rc || exit
. $rc_functions || exit

echo "Stopping IPX on the eth0 interface..."
/bin/ipx_configure --auto_interface=off --auto_primary=off &amp;&amp;
/bin/ipx_interface del eth0 802.2
evaluate_retval

# End /etc/sysconfig/network-devices/ifdown-ipx0
<command>EOF
echo "ONBOOT=yes" &gt; /etc/sysconfig/network-devices/ifconfig.ipx0
chmod 755 /etc/sysconfig/network-devices/ifup-ipx0
chmod 755 /etc/sysconfig/network-devices/ifdown-ipx0</command></userinput></screen>

</sect3>

</sect2>