f3aeeb5098457ae41d71d7c655b54ba5af9c49b5
[platform/upstream/krb5.git] / doc / html / _sources / build / directory_org.txt
1 Organization of the source directory
2 ====================================
3
4 Below is a brief overview of the organization of the complete source
5 directory.  More detailed descriptions follow.
6
7 =============== ==============================================
8 appl             Kerberos application client and server programs
9 ccapi            Credential cache services
10 clients          Kerberos V5 user programs (See :ref:`user_commands`)
11 config           Configure scripts
12 config-files     Sample Kerberos configuration files
13 include          include files needed to build the Kerberos system
14 kadmin           Administrative interface to the Kerberos master database: :ref:`kadmin(1)`, :ref:`kdb5_util(8)`, :ref:`ktutil(1)`.
15 kdc              Kerberos V5 Authentication Service and Key Distribution Center
16 lib_             Libraries for use with/by Kerberos V5
17 plugins          Kerberos plugins directory
18 po               Localization infrastructure
19 prototype        Templates files containing the MIT copyright message and a placeholder for the title and description of the file.
20 slave            Utilities for propagating the database to slave KDCs :ref:`kprop(8)` and :ref:`kpropd(8)`
21 tests            Test suite
22 util_            Various utilities for building/configuring the code, sending bug reports, etc.
23 windows          Source code for building Kerberos V5 on Windows (see windows/README)
24 =============== ==============================================
25
26
27 .. _lib:
28
29 lib
30 ---
31
32 The lib directory contain several subdirectories as well as some
33 definition and glue files.
34
35   - The apputils directory contains the code for the generic network
36     servicing.
37   - The crypto subdirectory contains the Kerberos V5 encryption
38     library.
39   - The gssapi library contains the Generic Security Services API,
40     which is a library of commands to be used in secure client-server
41     communication.
42   - The kadm5 directory contains the libraries for the KADM5
43     administration utilities.
44   - The Kerberos 5 database libraries are contained in kdb.
45   - The krb5 directory contains Kerberos 5 API.
46   - The rpc directory contains the API for the Kerberos Remote
47     Procedure Call protocol.
48
49
50 .. _util:
51
52 util
53 ----
54
55 The util directory contains several utility programs and libraries.
56   - the programs used to configure and build the code, such as
57     autoconf, lndir, kbuild, reconf, and makedepend, are in this
58     directory.
59   - the profile directory contains most of the functions which parse
60     the Kerberos configuration files (krb5.conf and kdc.conf).
61   - the Kerberos error table library and utilities (et);
62   - the Sub-system library and utilities (ss);
63   - database utilities (db2);
64   - pseudo-terminal utilities (pty);
65   - bug-reporting program send-pr;
66   - a generic support library support used by several of our other
67     libraries;
68   - the build infrastructure for building lightweight Kerberos client
69     (collected-client-lib)
70   - the tool for validating Kerberos configuration files
71     (confvalidator);
72   - the toolkit for kernel integrators for building krb5 code subsets
73     (gss-kernel-lib);
74   - source code for building Kerberos V5 on MacOS (mac)
75   - Windows getopt operations (windows)