summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBen Kaduk <kaduk@mit.edu>2013-04-03 00:06:45 -0400
committerBen Kaduk <kaduk@mit.edu>2013-04-03 16:51:26 -0400
commit5a6d14918a3b5d003f248b66e88028f1b5e450b7 (patch)
treec66f91ce5babd2adb426c23a7e36d5b445b7a756
parent424bed7b2943e0bc32a3feab4c55a4ea056bfa21 (diff)
downloadkrb5-5a6d14918a3b5d003f248b66e88028f1b5e450b7.tar.gz
krb5-5a6d14918a3b5d003f248b66e88028f1b5e450b7.tar.xz
krb5-5a6d14918a3b5d003f248b66e88028f1b5e450b7.zip
Add a krb5-config man page
Missed when converting the old nroff man pages.
-rw-r--r--doc/conf.py1
-rw-r--r--doc/user/user_commands/index.rst1
-rw-r--r--doc/user/user_commands/krb5-config.rst85
-rw-r--r--src/man/Makefile.in4
4 files changed, 89 insertions, 2 deletions
diff --git a/doc/conf.py b/doc/conf.py
index 269ea2c7c2..0fe1cc1d41 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -286,6 +286,7 @@ man_pages = [
('user/user_commands/kpasswd', 'kpasswd', u'change a user\'s Kerberos password', [u'MIT'], 1),
('user/user_commands/kvno', 'kvno', u'print key version numbers of Kerberos principals', [u'MIT'], 1),
('user/user_commands/ksu', 'ksu', u'Kerberized super-user', [u'MIT'], 1),
+ ('user/user_commands/krb5-config', 'krb5-config', u'tool for linking against MIT Kerberos libraries', [u'MIT'], 1),
('user/user_config/k5login', 'k5login', u'Kerberos V5 acl file for host access', [u'MIT'], 5),
('user/user_config/k5identity', 'k5identity', u'Kerberos V5 client principal selection rules', [u'MIT'], 5),
('admin/admin_commands/krb5kdc', 'krb5kdc', u'Kerberos V5 KDC', [u'MIT'], 8),
diff --git a/doc/user/user_commands/index.rst b/doc/user/user_commands/index.rst
index b43fad69c7..7ce86a14c4 100644
--- a/doc/user/user_commands/index.rst
+++ b/doc/user/user_commands/index.rst
@@ -10,6 +10,7 @@ User commands
kinit.rst
klist.rst
kpasswd.rst
+ krb5-config.rst
ksu.rst
kswitch.rst
kvno.rst
diff --git a/doc/user/user_commands/krb5-config.rst b/doc/user/user_commands/krb5-config.rst
new file mode 100644
index 0000000000..b4a87ff08d
--- /dev/null
+++ b/doc/user/user_commands/krb5-config.rst
@@ -0,0 +1,85 @@
+.. _krb5-config(1):
+
+krb5-config
+===========
+
+SYNOPSIS
+--------
+
+**krb5-config**
+[**-**\ **-help** | **-**\ **-all** | **-**\ **-version** | **-**\ **-vendor** | **-**\ **-prefix** | **-**\ **-exec-prefix** | **-**\ **-defccname** | **-**\ **-defktname** | **-**\ **-defcktname** | **-**\ **-cflags** | **-**\ **-libs** [*libraries*]]
+
+
+DESCRIPTION
+-----------
+
+krb5-config tells the application programmer what flags to use to compile
+and link programs against the installed Kerberos libraries.
+
+
+OPTIONS
+-------
+
+**-**\ **-help**
+ prints a usage message. This is the default behavior when no options
+ are specified.
+
+**-**\ **-all**
+ prints the version, vendor, prefix, and exec-prefix.
+
+**-**\ **-version**
+ prints the version number of the Kerberos installation.
+
+**-**\ **-vendor**
+ prints the name of the vendor of the Kerberos installation.
+
+**-**\ **-prefix**
+ prints the prefix for which the Kerberos installation was built.
+
+**-**\ **-exec-prefix**
+ prints the prefix for executables for which the Kerberos installation
+ was built.
+
+**-**\ **-defccname**
+ prints the built-in default credentials cache location.
+
+**-**\ **-defktname**
+ prints the built-in default keytab location.
+
+**-**\ **-defcktname**
+ prints the built-in default client (initiator) keytab location.
+
+**-**\ **-cflags**
+ prints the compilation flags used to build the Kerberos installation.
+
+**-**\ **-libs** [*library*]
+ prints the compiler options needed to link against *library*.
+ Allowed values for *library* are:
+
+ ============ ===============================================
+ krb5 Kerberos 5 applications (default)
+ gssapi GSSAPI applications with Kerberos 5 bindings
+ kadm-client Kadmin client
+ kadm-server Kadmin server
+ kdb Applications that access the Kerberos database
+ ============ ===============================================
+
+EXAMPLES
+--------
+
+krb5-config is particularly useful for compiling against a Kerberos
+installation that was installed in a non-standard location. For example,
+a Kerberos installation that is installed in ``/opt/krb5/`` but uses
+libraries in ``/usr/local/lib/`` for text localization would produce
+the following output:
+
+ ::
+
+ shell% krb5-config --libs krb5
+ -L/opt/krb5/lib -Wl,-rpath -Wl,/opt/krb5/lib -L/usr/local/lib -lkrb5 -lk5crypto -lcom_err
+
+
+SEE ALSO
+--------
+
+kerberos(1), cc(1)
diff --git a/src/man/Makefile.in b/src/man/Makefile.in
index 19617eee20..17385018bf 100644
--- a/src/man/Makefile.in
+++ b/src/man/Makefile.in
@@ -13,8 +13,8 @@ DEFCKTNAME=@DEFCKTNAME@
MANSUBS=k5identity.sub k5login.sub k5srvutil.sub kadm5.acl.sub kadmin.sub \
kadmind.sub kdb5_ldap_util.sub kdb5_util.sub kdc.conf.sub \
kdestroy.sub kinit.sub klist.sub kpasswd.sub kprop.sub kpropd.sub \
- kproplog.sub krb5.conf.sub krb5kdc.sub ksu.sub kswitch.sub \
- ktutil.sub kvno.sub sclient.sub sserver.sub
+ kproplog.sub krb5.conf.sub krb5-config.sub krb5kdc.sub ksu.sub \
+ kswitch.sub ktutil.sub kvno.sub sclient.sub sserver.sub
docsrc=$(top_srcdir)/../doc