Changeset 4bab639 in freewrt for docs

Timestamp:

Jul 7, 2007, 7:14:27 PM (18 years ago)

Author:

Phil Sutter <n0-1@…>

Branches:

freewrt_1_0, freewrt_2_0

Children:

8ffbc93

Parents:

9224613

Message:

• enable txfonts again (fonts were looking like chaos before?!)
• add some usb-storage documentation

git-svn-id: ​svn://www.freewrt.org/branches/freewrt_1_0@3162 afb5a338-a214-0410-bd46-81f09a774fd1

File:

• docs/handbook/user/handbook.tex (modified) (2 diffs)

docs/handbook/user/handbook.tex

@@ -8 +8 @@
 \usepackage[english]{babel} % Sets the layout to English style
 \usepackage{varioref} % Intelligent page references
-%\usepackage{txfonts}
+\usepackage{txfonts}
 \usepackage[pdftex]{color} % Colour control for LaTeX documents
 \usepackage[pdftex]{graphicx} % Enhanced support for graphics
@@ -1481 +1481 @@
 bootup.
 
+\section{Accessing USB storage devices}
+
+Many routers now ship with USB onboard, which makes them fine for dealing as a
+fileserver. If you have such a device and want to setup your own low--cost NAS,
+follow the instructions below.
+
+\subsection{Firmware image preparation}
+
+What you need is:
+\begin{itemize}
+        \item kernel support for \code{usb-storage}
+        \item kernel support for the filesystem(s) to be used, e.g. \code{xfs}
+        \item optionally: \app{lsusb} to check for attached devices
+\end{itemize}
+
+When all prerequisites are met, all that has to be done is to connect the USB
+mass storage device to the USB port of the router. FreeWRT provides a
+hotplugging script which mounts all connected partitions under
+\file{/mnt/discN\_Y} while \code{N} is the index of the connected disk (i.e.
+starting with 0) and \code{Y} is the number of the partition on the disk (i.e.
+starting with 1).
+
+\subsection{Sharing storage via NFS}
+
+There are two implementations available, one residing in kernel space and
+another one implemented purely in user space.  If you wish to use the user space
+implementation of NFS, just enable \app{nfs-server}.  To use the kernel
+implementation of NFS, activate \app{nfs-utils} for your target. Although
+kernel space is somewhat faster, this implementation has the drawback that only
+directory structures within a single mount point can be exported. So you have
+to supply at least a single entry for each mounted partition in
+\file{/etc/exports}. (Using the user space \app{nfsd}, you can also export the
+complete \file{/mnt} directory.
+
+\begin{Verbatim}[label=sample /etc/exports]
+/mnt/disc0_1    *(ro,no_root_squash,insecure,no_subtree_check)
+/mnt/disc0_2    *(rw,root_squash,insecure,no_subtree_check)
+\end{Verbatim}
+
+Finally, start \app{portmap} and \app{knfsd} (\app{nfsd} when using the user
+space implementation):
+\begin{Verbatim}[label=starting the daemons]
+# /etc/init.d/portmap start
+# /etc/init.d/knfsd start
+\end{Verbatim}
 
 \chapter{Troubleshooting}\label{ch:troubleshooting}