summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--rules/arora.in3
-rw-r--r--rules/db.in4
-rw-r--r--rules/dhcp.in18
-rw-r--r--rules/dri2proto.in6
-rw-r--r--rules/fbutils.in3
-rw-r--r--rules/glibc.in11
-rw-r--r--rules/gpsd.in68
-rw-r--r--rules/kexec-tools.in10
-rw-r--r--rules/lcms.in3
-rw-r--r--rules/libgsf.in12
-rw-r--r--rules/libmd.in2
-rw-r--r--rules/libmicrohttpd.in7
-rw-r--r--rules/liboop.in8
-rw-r--r--rules/libpv.in3
-rw-r--r--rules/librsvg.in8
-rw-r--r--rules/libucdaemon.in5
-rw-r--r--rules/lsh.in20
-rw-r--r--rules/mbw.in8
-rw-r--r--rules/mgetty.in4
-rw-r--r--rules/ntp.in20
-rw-r--r--rules/opkg.in11
-rw-r--r--rules/ppp.in31
-rw-r--r--rules/proftpd.in37
23 files changed, 233 insertions, 69 deletions
diff --git a/rules/arora.in b/rules/arora.in
index 2e0ab065b..fcfadae99 100644
--- a/rules/arora.in
+++ b/rules/arora.in
@@ -7,4 +7,5 @@ config ARORA
select QT4_BUILD_WEBKIT
select QT4_BUILD_QTXMLPATTERNS
help
- FIXME
+ Arora is a lightweight web browser based on Qt4 (WebKit).
+ Project page: http://code.google.com/p/arora/
diff --git a/rules/db.in b/rules/db.in
index d5c4c6897..c9562aa69 100644
--- a/rules/db.in
+++ b/rules/db.in
@@ -5,7 +5,9 @@ menuconfig DB
prompt "berkeley db "
select GCCLIBS_GCC_S
help
- FIXME
+ The well known Berkeley DB, a library that provides a
+ high-performance embedded database for key/value data.
+ Project page: http://www.oracle.com/technetwork/database/berkeleydb/overview/index.html
if DB
diff --git a/rules/dhcp.in b/rules/dhcp.in
index 018619827..f2b920c1b 100644
--- a/rules/dhcp.in
+++ b/rules/dhcp.in
@@ -20,7 +20,11 @@ config DHCP_SERVER
bool
prompt "DHCP Server dhcpd"
help
- FIXME
+ This is the main component of the DHCP server, the daemon process
+ that allows a server to provide a Dynamic Host Configuration
+ Protocol service to a network.
+ It takes its configuration from /etc/dhcp3/dhcpd.conf and tracks
+ issued addresses as records in the dhcpd.leases file.
config DHCP_DHCPD_CONF
bool "Install /etc/dhcpd.conf"
@@ -67,6 +71,16 @@ config DHCP_RELAY
bool
prompt "DHCP Relay dhcrelay"
help
- FIXME
+ The Internet Systems Consortium DHCP Relay Agent, dhcrelay, provides a
+ means for relaying DHCP and BOOTP requests from a subnet to which no
+ DHCP server is directly connected to one or more DHCP servers on other
+ subnets.
+
+ The DHCP Relay Agent listens for DHCP and BOOTP queries and responses.
+ When a query is received from a client, dhcrelay forwards it to the
+ list of DHCP servers specified on the command line. When a reply is
+ received from a server, it is broadcast or unicast (according to the
+ relay agent's ability or the client's request) on the network from
+ which the original request came.
endif
diff --git a/rules/dri2proto.in b/rules/dri2proto.in
index 3326064dd..470b750f7 100644
--- a/rules/dri2proto.in
+++ b/rules/dri2proto.in
@@ -3,4 +3,8 @@
config DRI2PROTO
tristate
help
- FIXME
+ Direct Rendering Infrastructure 2 Extension
+ This extension defines a protocol to securely allow user
+ applications to access the video hardware without requiring
+ data to be passed through the X server.
+
diff --git a/rules/fbutils.in b/rules/fbutils.in
index 65508d2f8..9db5f3984 100644
--- a/rules/fbutils.in
+++ b/rules/fbutils.in
@@ -51,6 +51,7 @@ config FBUTILS_FBCONVERT
default y
prompt "install fbconvert util on target"
help
- FIXME: This item needs to be documented
+ Converts from the old fb.modes format to the new one
+ (/etc/fb.modes contains video mode descriptions.)
endif
diff --git a/rules/glibc.in b/rules/glibc.in
index 28d21758f..19856c8e2 100644
--- a/rules/glibc.in
+++ b/rules/glibc.in
@@ -111,8 +111,9 @@ config GLIBC_NSS_FILES
bool
prompt "Install libnss_files"
help
- Contains functions to access some vitale system control files (for
+ Contains functions to access some vital system control files (for
login for example) and for name resolution to ip addresses.
+ NSS is the "Name Service Switch", controlled by /etc/nsswitch.conf
config GLIBC_NSS_HESIOD
bool
@@ -120,7 +121,7 @@ config GLIBC_NSS_HESIOD
select GLIBC_RESOLV
select GLIBC_NSS_FILES
help
- FIXME: This item needs to be documented
+ Adds the hesiod libnss source for user lookups
config GLIBC_NSS_NIS
bool
@@ -128,21 +129,21 @@ config GLIBC_NSS_NIS
select GLIBC_NSL
select GLIBC_NSS_FILES
help
- FIXME: This item needs to be documented
+ Adds the NIS (NIS version 2), also called YP, libnss source
config GLIBC_NSS_NISPLUS
bool
prompt "Install libnss_nisplus"
select GLIBC_NSL
help
- FIXME: This item needs to be documented
+ Adds the NIS+ (NIS version 3) libnss source
config GLIBC_NSS_COMPAT
bool
prompt "Install libnss_compat"
select GLIBC_NSL
help
- FIXME: This item needs to be documented
+ Adds the NIS libnss source on compat mode
config GLIBC_RESOLV
bool
diff --git a/rules/gpsd.in b/rules/gpsd.in
index dd93cbb1d..824983b66 100644
--- a/rules/gpsd.in
+++ b/rules/gpsd.in
@@ -177,69 +177,115 @@ menu "install options"
bool
prompt "gpsd"
help
- FIXME
+ gpsd is a service daemon that monitors one or more
+ GPS- or AIS receivers attached through serial or USB
+ ports, making all data on the location/course/velocity
+ of the sensors available to be queried on TCP port 2947
+ of the host. With gpsd, multiple location-aware client
+ applications can share access to receivers without
+ contention or loss of data. Also, gpsd responds to
+ queries with a format that is substantially easier to
+ parse than the NMEA 0183 emitted by most GPS receivers.
config GPSD_GPSCTL
bool
prompt "gpsctl"
help
- FIXME
+ The gpsctl tool for tweaking GPS settings.
+ gpsctl can switch a dual-mode GPS between NMEA and
+ vendor-binary modes. It can also be used to set the
+ device baudrate. Note: Not all devices have these
+ capabilities.
config GPSD_GPSPIPE
bool
prompt "gpspipe"
help
- FIXME
+ A simple client that captures GPS output and/or gpsd
+ reports and sends it to standard output.
+ gpspipe is a tool to connect to gpsd and output the
+ received sentences to stdout. This makes the program
+ useful as a pipe from gpsd to another program or file.
config GPSD_GPSFLASH
bool
prompt "gpsflash"
help
- FIXME
+ This program is a firmware loader for GPS receivers
+ connected via serial or USB port. Presently it supports
+ only SiRF GPSes.
config GPSD_GPXLOGGER
bool
prompt "gpxlogger"
help
- FIXME
+ This program listens to DBUS broadcasts from gpsd
+ (org.gpsd.fix) and logs each fix to standard output as
+ they arrive in an XML format.
config GPSD_CGPS
bool
prompt "cgps"
help
- FIXME
+ cgps is a client resembling xgps, but without the
+ pictorial satellite display and able to run on a serial
+ terminal or terminal emulator.
config GPSD_GPSMON
bool
prompt "gpsmon"
select NCURSES
help
- FIXME
+ The gpsmon real-time packet monitor and diagnostic tool.
+ (This replaces the sirfmon tool in older versions.)
+ gpsmon is a monitor that watches packets coming from a
+ GPS and displays them along with diagnostic information.
+ It supports commands that can be used to tweak GPS settings
+ in various ways; some are device-independent, some vary
+ with the GPS chipset type.
config GPSD_GPSDECODE
bool
depends on GPSD_DRIVER_RTCM104V2
prompt "gpsdecode"
help
- FIXME
+ The gpsdecode packet decoder.
+ This tool is a batch-mode decoder for NMEA and various
+ binary packet formats associated with GPS, AIS, and
+ differential-correction services.
config GPSD_GPSCAT
bool "gpscat"
select GPSD_PYTHON
help
- FIXME
+ The gpscat tool dumps output from a serial device.
+ Optionally, it can packetize the data.
+ gpscat is a simple program for logging and packetizing
+ GPS data streams. It takes input from a specified file
+ or serial device (presumed to have a GPS attached) and
+ reports to standard output.
config GPSD_GPSFAKE
bool "gpsfake"
select GPSD_PYTHON
help
- FIXME
+ The gpsfake test harness simulating a GPS receiver.
+ gpsfake is a test harness for gpsd and its clients. It
+ opens a pty (pseudo-TTY), launches a gpsd instance that
+ thinks the slave side of the pty is its GPS device, and
+ repeatedly feeds the contents of one or more test logfiles
+ through the master side to the GPS.
config GPSD_GPSPROF
bool "gpsprof"
select GPSD_PYTHON
help
- FIXME
+ The gpsprof program for plotting spatial scatter of fixes
+ and fix latency.
+ gpsprof measures the various latencies between a GPS and
+ its client. It emits to standard output a GNUPLOT program
+ that draws an illustrative graph. It can also be told to
+ emit the raw profile data.
endmenu
diff --git a/rules/kexec-tools.in b/rules/kexec-tools.in
index 12e1bbb22..1f769ac02 100644
--- a/rules/kexec-tools.in
+++ b/rules/kexec-tools.in
@@ -15,7 +15,7 @@ config KEXEC_TOOLS_GAMECUBE
depends on BROKEN
prompt "Support for Gamecube"
help
- FIXME
+ kexec has been ported to the GameCube/PPC32 platform.
config KEXEC_TOOLS_ZLIB
bool
@@ -28,7 +28,7 @@ config KEXEC_TOOLS_XEN
depends on BROKEN
prompt "Xen support"
help
- FIXME
+ kexec has been ported to xen for the hypervisor and domain 0.
config KEXEC_TOOLS_KEXEC
bool
@@ -40,6 +40,10 @@ config KEXEC_TOOLS_KDUMP
bool
prompt "Install kdump"
help
- FIXME
+ Kdump is a kexec based crash dumping mechansim for Linux.
+ Its functionality is broken mainly into two components,
+ user space and kernel space. Kernel space patches are
+ already part of main line kernel tree. User space component
+ is nothing but a patch on top of existing kexec tools.
endif
diff --git a/rules/lcms.in b/rules/lcms.in
index 7575a8ec5..b7bae423b 100644
--- a/rules/lcms.in
+++ b/rules/lcms.in
@@ -5,4 +5,5 @@ config LCMS
prompt "lcms"
select LIBC_M
help
- FIXME
+ LittleCMS intends to be a small-footprint, speed
+ optimized color management engine in open source form.
diff --git a/rules/libgsf.in b/rules/libgsf.in
index d67c06272..7ca925151 100644
--- a/rules/libgsf.in
+++ b/rules/libgsf.in
@@ -23,26 +23,30 @@ config LIBGSF_NLS
bool
prompt "NLS Support"
help
- FIXME
+ National Language Support integration into libgsf
+ for internationalization
config LIBGSF_PYTHON
bool
depends on BROKEN
prompt "Python support"
help
- FIXME
+ Configures whether to build with Python support. Should be
+ turned off. MUST be turned off if Python is not installed.
config LIBGSF_BZ2
bool
prompt "bz2 support"
help
- FIXME
+ Configures whether to build with bzip2 support.
+ bzip2 is a freely available, high-quality data compressor.
config LIBGSF_GIO
bool
prompt "GIO support"
help
- FIXME
+ Configures whether to build with GIO support.
+ GIO is the Gnome I/O library for GVFS.
endif
diff --git a/rules/libmd.in b/rules/libmd.in
index 8dcf32617..7e8e0e1b7 100644
--- a/rules/libmd.in
+++ b/rules/libmd.in
@@ -9,7 +9,7 @@ menuconfig LIBMD
MD4 (RFC 1186 - R. Rivest)
MD5 (RFC 1321 - R. Rivest)
SHA-1 (FIPS PUB 180 and 180.1 - NIST)
- RIPEMD-160FIXME
+ RIPEMD-160 (http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html)
It could be used by the upcoming new Xorg server if you don't want
the openssl package on your target. If there is already openssl
present, the Xorg server can use the SHA-1 from the openssl library
diff --git a/rules/libmicrohttpd.in b/rules/libmicrohttpd.in
index e69cc1c43..6ba782f26 100644
--- a/rules/libmicrohttpd.in
+++ b/rules/libmicrohttpd.in
@@ -18,7 +18,10 @@ config LIBMICROHTTPD_HTTPS
bool
prompt "HTTPS support"
help
- FIXME
+ Run in https mode (this option may not work with all
+ threading modes yet).
+ If you disable HTTPS/SSL support, you can also choose the
+ eCos License.
config LIBMICROHTTPD_CLIENT_SIDE
bool
@@ -30,6 +33,6 @@ config LIBMICROHTTPD_MESSAGES
bool
prompt "Messages"
help
- FIXME
+ Enable MHD error messages
endif
diff --git a/rules/liboop.in b/rules/liboop.in
index 1d76a61b7..16a5b26c2 100644
--- a/rules/liboop.in
+++ b/rules/liboop.in
@@ -3,4 +3,10 @@ config LIBOOP
tristate
prompt "liboop"
help
- FIXME
+ Liboop provides a generic, callback-based event dispatch
+ interface, and aims to ease the development of multiplexed,
+ non-blocking, event-driven modular applications, components,
+ and libraries under POSIX-based operating systems. It
+ includes adapters for select(), poll(), the glib event loop,
+ the TCL event loop, the W3C libwww, asynchronous DNS, and
+ GNU readline.
diff --git a/rules/libpv.in b/rules/libpv.in
index 790e3ec30..b4c3fa558 100644
--- a/rules/libpv.in
+++ b/rules/libpv.in
@@ -32,7 +32,8 @@ config LIBPV_PYTHON
bool
prompt "Python bindings"
help
- FIXME: This item needs to be documented
+ Install libpv Python bindings, a Python module supporting
+ PvEngine, PvEngineAttr and Pv.
config LIBPV_PVTOOL
bool
diff --git a/rules/librsvg.in b/rules/librsvg.in
index 66d5b7b9a..759bea4c7 100644
--- a/rules/librsvg.in
+++ b/rules/librsvg.in
@@ -19,19 +19,21 @@ config LIBRSVG_PIXBUF_LOADER
bool
prompt "pixbuf loader support"
help
- FIXME
+ This enables the librsvg-based gdk-pixbuf loader.
config LIBRSVG_SVGZ
bool
prompt "svgz support"
help
- FIXME
+ Adds support for the ompressed Scalable Vector Graphics
+ file format (SVGZ)
config LIBRSVG_CROCO
bool
prompt "libcroco support"
help
- FIXME
+ Libcroco is a general CSS parsing and manipulation library.
+ It enhances librsvg to provide extra features.
endif
diff --git a/rules/libucdaemon.in b/rules/libucdaemon.in
index 708620aba..c6d69fe99 100644
--- a/rules/libucdaemon.in
+++ b/rules/libucdaemon.in
@@ -3,4 +3,7 @@ config LIBUCDAEMON
tristate
prompt "libucdaemon"
help
- FIXME
+ libdaemon is a lightweight C library that eases the process
+ of writing UNIX daemons. It contains a daemonizing fork()
+ wrapper, a powerful syslog() wrapper, PID file management,
+ and signal serialization.
diff --git a/rules/lsh.in b/rules/lsh.in
index feb141ce8..30c25f303 100644
--- a/rules/lsh.in
+++ b/rules/lsh.in
@@ -34,19 +34,31 @@ config LSH_MAKESEED
bool
prompt "Install lsh-make-seed"
help
- FIXME: This item needs to be documented
+ lsh-make-seed - Creates an initial random seed file for
+ the YARROW pseudorandomnessgenerator used by lsh.
-config LSH_KEYGEN
+config LSH_KEYGEN
bool
prompt "Install lsh-keygen"
help
- FIXME: This item needs to be documented
+ lsh-keygen - Generates a keypair and write it on stdout.
+ Generates a new private key for the desired algorithm
+ and security level and write it on stdout.
+
+ You will usually want to pipe the new key into a program
+ like lsh-writekey, to split it into its private and public
+ parts, and optionally encrypt the private information.
config LSH_WRITEKEY
bool
prompt "Install lsh-writekey"
help
- FIXME: This item needs to be documented
+ lsh-writekey - Keypair split/store handler.
+ Splits a keypair in one private and one public file,
+ optionally encrypting the private file using a passphrase.
+
+ Common usage is to pipe the output from lsh-keygen into
+ this program.
endif
diff --git a/rules/mbw.in b/rules/mbw.in
index a3abadf30..1f0d5b3dd 100644
--- a/rules/mbw.in
+++ b/rules/mbw.in
@@ -3,4 +3,10 @@ config MBW
tristate
prompt "mbw"
help
- FIXME
+ MBW memory bandwidth benchmark
+
+ MBW determines the "copy" memory bandwidth available to
+ userspace programs. Its simplistic approach models that
+ of real applications. It is not tuned to extremes and it
+ is not aware of hardware architecture, just like your
+ average software package.
diff --git a/rules/mgetty.in b/rules/mgetty.in
index 99710a2c0..79d7b9b52 100644
--- a/rules/mgetty.in
+++ b/rules/mgetty.in
@@ -22,7 +22,9 @@ config MGETTY_CONFIG
string
default "${MGETTY_DIR}/policy.h-dist"
help
- FIXME: This item needs to be documented
+ policy.h-dist is the default policy.h file provided by the
+ distribution. It will be renamed to policy.h and used if
+ no other policy.h file is supplied.
config MGETTY_INSTALL_CONFIG
prompt "Install default config files to ${ROOTDIR}/etc/mgetty+sendfax"
diff --git a/rules/ntp.in b/rules/ntp.in
index 35c5057c7..24dec72a9 100644
--- a/rules/ntp.in
+++ b/rules/ntp.in
@@ -10,7 +10,7 @@ menuconfig NTP
select GCCLIBS_GCC_S
select LIBMD
help
- Build the standard NTP Daemon Process an supplementary programs.
+ Build the standard NTP Daemon Process and supplementary programs.
This conflicts with BSD openntpd.
# ----- Compile Options
@@ -100,7 +100,7 @@ config NTP_TICKADJ
config NTP_SIMULATOR
bool
- prompt "build/install the NTPD simulator?"
+ prompt "build/install the NTPD simulator"
help
FIXME: This item needs to be documented
@@ -126,31 +126,31 @@ config NTP_STEP_SLEW
config NTP_NTPDATE_STEP
bool
- prompt "if ntpdate should step the time"
+ prompt "ntpdate should step the time"
help
FIXME: This item needs to be documented
config NTP_HOURLY_TODR_SYNC
bool
- prompt "if we should sync TODR hourly"
+ prompt "sync TODR hourly"
help
FIXME: This item needs to be documented
config NTP_KERNEL_FLL_BUG
bool
- prompt "if we should avoid a kernel FLL bug"
+ prompt "avoid a kernel FLL bug"
help
If we should avoid a (Solaris) kernel FLL bug.
config NTP_IRIG_SAWTOOTH
bool
- prompt "if we should enable the IRIG sawtooth filter"
+ prompt "enable the IRIG sawtooth filter"
help
FIXME: This item needs to be documented
config NTP_NIST
bool
- prompt "if we should enable the NIST lockclock scheme"
+ prompt "enable the NIST lockclock scheme"
help
FIXME: This item needs to be documented
@@ -162,13 +162,13 @@ config NTP_CRYPTO
config NTP_SNTP
bool
- prompt "Build SNTP"
+ prompt "build SNTP"
help
FIXME: This item needs to be documented
config NTP_ARLIB
bool
- prompt "Compile the async resolver library"
+ prompt "compile the async resolver library"
help
FIXME: This item needs to be documented
@@ -176,7 +176,7 @@ comment "Clock drivers"
config NTP_ALL_CLOCK_DRIVERS
bool
- prompt "Build all clock drivers"
+ prompt "build all clock drivers"
default y
help
Disabling this entry will only build a set of selected clock drivers.
diff --git a/rules/opkg.in b/rules/opkg.in
index cc45f755f..842942aa1 100644
--- a/rules/opkg.in
+++ b/rules/opkg.in
@@ -18,13 +18,22 @@ config OPKG_PATHFINDER
# needs pathfinder-openssl
depends on BROKEN
help
- FIXME
+ Pathfinder is designed to provide a mechanism for any
+ program to perform RFC3280-compliant path validation
+ of X.509 certificates, even when some of the intermediate
+ certificates are not present on the local machine. It will
+ automatically download any such certificates (and their
+ CRLs) from the Internet as needed using the AIA and CRL
+ distribution point extensions of the certificate it is
+ processing.
config OPKG_CURL
bool
prompt "libcurl support"
help
FIXME - is this optional?
+ curl is a command line tool for transferring data with
+ URL syntax.
config OPKG_SHA256
bool
diff --git a/rules/ppp.in b/rules/ppp.in
index 9842233d3..4795100f3 100644
--- a/rules/ppp.in
+++ b/rules/ppp.in
@@ -115,25 +115,33 @@ config PPP_OATM
bool
prompt "ppp over atm"
help
- FIXME: This item needs to be documented
+ Asynchronous Transfer Mode (ATM) designates a type of
+ telecommunication networks using asynchronous time-division
+ multiplexing.
config PPP_RADIUS
bool
prompt "radius"
help
- FIXME: This item needs to be documented
+ Remote Authentication Dial In User Service (RADIUS) is often
+ used for authentication, authorization in remote login scenarios.
config PPP_RADATTR
bool
prompt "radattr"
help
- FIXME: This item needs to be documented
+ The radattr plugin for pppd causes all radius attributes
+ returned by the RADIUS server at authentication time to be
+ stored in the file /var/run/radattr.pppN where pppN is the
+ name of the PPP interface.
config PPP_RADREALMS
bool
prompt "radrealms"
help
- FIXME: This item needs to be documented
+ A pppd plugin which is stacked on top of radius.so. This plugin
+ allows selection of alternate set of servers based on the user's
+ realm.
config PPP_OE
bool
@@ -148,25 +156,29 @@ config PPP_MINCONN
bool
prompt "minconn"
help
- FIXME: This item needs to be documented
+ pppd plugin to implement a 'minconnect' option
+ (Set minimum connect time before idle timeout applies)
config PPP_PASSPROMPT
bool
prompt "passprompt"
help
- FIXME: This item needs to be documented
+ pppd plugin to invoke an external PAP password prompter
config PPP_PASSWORDFD
bool
prompt "passwordfd"
help
- FIXME: This item needs to be documented
+ This plugin let's you pass the password to the pppd via
+ a file descriptor. That's easy and secure - no fiddling
+ with pap- and chap-secrets files.
config PPP_WINBIND
bool
prompt "winbind"
help
- FIXME: This item needs to be documented
+ WINBIND plugin for pppd. Performs PAP, CHAP, MS-CHAP, MS-CHAPv2
+ authentication using WINBIND to contact a NT-style PDC.
endif
@@ -197,7 +209,8 @@ config PPP_INST_PPPSTATS
config PPP_INST_PONOFF
bool "install pon/poff"
help
- FIXME
+ pon and poff are helper commands to start and close a ppp
+ connection.
config PPP_STARTSCRIPT
bool
diff --git a/rules/proftpd.in b/rules/proftpd.in
index 14f54f7c3..7d672f674 100644
--- a/rules/proftpd.in
+++ b/rules/proftpd.in
@@ -30,20 +30,48 @@ config PROFTPD_PAM
prompt "PAM support"
depends on BROKEN
help
- FIXME: This item needs to be documented
+ PAM, which stands for Pluggable Authentication Modules,
+ is an API intended to make it easy to replace the old
+ Unix-style DES password hashes with a flexible system that
+ allows to use MD5 checksums, SQL tables, LDAP servers, RADIUS
+ servers, etc in place of that password check.
+ However, what PAM does not provide is the rest of the user
+ account information in /etc/passwd, i.e. the user's UID and
+ GID, home directory, and shell. This means that PAM cannot
+ be used as a drop-in replacement for user information stored
+ in /etc/passwd. NSS (Name Service Switch) modules, supported
+ by some operating systems, are a complementary API to PAM
+ which can be used to supply the rest of this user information.
+
+ proftpd uses the normal libc functions for looking up user
+ information, and those libc functions typically read
+ /etc/passwd. NSS is an abstraction layer within some libc
+ implementations that causes those functions to read other
+ sources rather than /etc/passwd.
config PROFTPD_SENDFILE
bool
prompt "sendfile support"
help
- FIXME: This item needs to be documented
+ Unix kernels handle a socket as just another file descriptor;
+ this means that sendfile(2) can be used to efficiently copy
+ data from a file on disk to a network socket, e.g. for
+ downloading a file.
+
+ As useful as the sendfile(2) function can be, there are
+ unfortunately cases where bad implementations of the function
+ can cause problems. These problems manifest as broken or
+ aborted downloads, or as downloaded data being corrupted, or
+ even as downloaded files being larger than the original file.
config PROFTPD_SHADOW
bool
prompt "shadow support"
default y
help
- FIXME: This item needs to be documented
+ Some operating systems require you to use either
+ --enable-autoshadow or --enable-shadow if you wish to use
+ the system's shadow password file for user authentication.
config PROFTPD_AUTOSHADOW
bool
@@ -51,7 +79,8 @@ config PROFTPD_AUTOSHADOW
depends on PROFTPD_SHADOW
default y
help
- FIXME: This item needs to be documented
+ Using autoshadow allows proftpd to work with either shadow
+ or traditional password files.
config PROFTPD_STARTSCRIPT
bool