source-map-20020121

with modifications by shadow@dementia.org

a guide to what's where in the OpenAFS source

====================
This delta was composed from multiple commits as part of the CVS->Git migration.
The checkin message with each commit was inconsistent.
The following are the additional commit messages.
====================

with modifications by shadow@dementia.org

a guide to what's where in the OpenAFS source

this time the right file. a sure sign that it's bedtime.

diff --git a/src/SOURCE-MAP b/src/SOURCE-MAP
new file mode 100644 (file)
index 0000000..bbd5b3f
--- /dev/null
+++ b/src/SOURCE-MAP
@@ -0,0 +1,109 @@
+Guide to the AFS source tree
+
+WINNT     - Windows-specific UI, glue and such.
+afs        - routines which make up the kernel- and userlevel- cachemanager
+afsd       - the afsd process which parses config files, sets up the cache, 
+             and forks off subprocess to start each of the libafs 
+             "kernel threads" 
+afsmonitor - afs monitoring tool
+afsweb     - authenticated AFS access via Apache. requires minor porting for 
+            newer Apache versions.
+audit      - afs event auditing support library
+auth       - afsconf suite (CellServDB/UserList/ThisCell) and token interface,
+            outdated copyauth program, setkey utility for adding a key
+            to a server KeyFile (as a key)
+bozo      - bos suite
+bubasics   - backup related rpc interface definitions.
+bucoord    - backup coordinator and support library.
+budb       - backup database server (buserver).
+butc       - backup tape coordinator, and read_tape restoral client.
+butm       - backup tape manager library
+bu_utils   - fms(estimate tape capacity and file mark sizes) (not useful
+             for tape drives with compression)
+cmd        - cmd library, routines to parse cmd line arguments
+             used by all command line utilities
+comerr     - com_err library, error table routines
+config     - build system OS-specific configuration
+dauth      - dlog - get a krb ticket for use with the AFS/DFS translator
+             dpass - also part of the AFS/DFS migration kit
+des        - des library
+des_stub   - remnant of export restrictions on encryption code.
+dir        - afs directory handling library (client and server, internal format)
+export     - from the README:
+        EXPORT is an aix3.1 kernel extension whose sole purpose in
+        life is to provide access to kernel symbols that were mistakenly
+        (or purposefully) omitted from the kernel exports list.
+finale     - last part of the source to build: 
+            translate_et - translates error codes to descriptive messages
+fsint      - fileserver rpc interface definitions
+fsprobe    - fileserver probe facility for information collection
+ftpd43+    - insecure afs aware ftpd. 
+gtx        - graphics library for monitoring clients
+inetd      - insecure afs aware inetd.
+kauth      - Kerberos suite including server, admin client, password 
+            changing and validating clients, token-getting and 
+            token-and-ticket-getting authentication clients, nfs
+            authentication exporter and server database reconstructor
+libacl     - acl library, routines for manipulation of ACLs
+libadmin   - AFS administration API
+libafs     - directory where build system actually builds kernel modules.
+libafsauthent - afsauthent library. part of a simplified set of libraries
+            for AFS-aware utilties. This and libafsrpc provide complete
+            functionality.
+libafsrpc  - afsrpc library. Provides basic Rx functionality for AFS-aware
+            programs which don't need to do authentication
+libuafs    - userlevel cache manager build directory
+log        - programs to show and forget tokens (and optionally forget tokens 
+            and tickets) and test program to create an AFS token
+login      - afs aware login replacement, and optional replacement which
+            gets kerberos tickets
+lwp        - lightweight process library
+mpp        - macro processor for use with package
+ntp        - out of date bundled NTP implementation
+null       - empty archive library
+package    - package system for local disk software maintenance
+pam        - pluggable authentication modules for afs authentication.
+pinstall   - "portable" install command
+procmgmt   - "portable" process management library.
+ptserver   - the protection database server and clients.
+rcp        - insecure afs aware rcp.
+rlogind    - insecure afs aware.
+rsh        - insecure afs aware rsh.
+rx         - rx rpc library.
+rxdebug    - debugging tool for rx.
+rxgen      - rxgen program. generates AFS RPC stubs from .xg files.
+rxkad      - kerberos security module for rx.
+rxstat     - rx statistics package
+scout      - monitoring tool for afs fileservers.
+sgistuff   - SGI authentication plugin for graphical login
+sia        - Digital UNIX authentication plugin
+sys        - local and remote system call interfaces. basic PAG-creation 
+            and remote system call handling for NFS translator
+tbutc      - pthread version of butc.
+tests      - test suite
+tsm41      - tivoli storage manager support for the backup system.
+tviced     - pthread version of the fileserver
+ubik       - ubik replicated database library.
+update     - upserver/upclient for maintaining server software from a system
+            control machine
+usd        - userspace device input/output library.
+uss        - uss tool for managing users.
+util       - swiss army knife library.
+venus      - various cachemanager related utilities
+vfsck      - fsck for vice partitions on non-namei fileservers.
+viced      - fileserver.
+vlserver   - volume location server
+vol        - volume library for managing volumes on-disk.
+volser     - volume server package. includes volserver and vos client.
+wsadmin.src - sample package files
+wsadmin.lib - sample package files
+xstat      - extended statistics clients for cachemanagers and fileservers
+xinstall   - unused more modern install program
+tools      - contributed configuration/maintenance tools
+man        - man pages
+include    - build-time include file install area; may be used in automake time
+cf         - autoconf config files
+afsinstall - leftovers from IBM AFS including installation notes and helper
+            scripts
+
+