From 25ad02d691a5bb4084323e5183fdd8ab56e20263 Mon Sep 17 00:00:00 2001 From: Assar Westerlund Date: Wed, 2 May 2001 08:59:23 +0000 Subject: [PATCH] mdoc fixes from ru@freebsd.org git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@9830 ec53bebd-3082-4978-b11e-865c3cabbd6b --- admin/ktutil.8 | 3 +- appl/ftp/ftpd/ftpd.8 | 3 +- appl/ftp/ftpd/ftpusers.5 | 3 +- appl/kf/kf.1 | 70 +++++++++++++----------------- appl/kf/kfd.8 | 34 +++++++-------- appl/push/pfrom.1 | 3 +- appl/push/push.8 | 13 +++--- kadmin/kadmin.8 | 33 +++++++------- kadmin/kadmind.8 | 5 +-- kdc/hprop.8 | 14 +++--- kdc/hpropd.8 | 5 +-- kdc/kdc.8 | 3 +- kdc/kstash.8 | 3 +- kdc/string2key.8 | 3 +- kpasswd/kpasswd.1 | 3 +- kpasswd/kpasswdd.8 | 3 +- kuser/kdestroy.1 | 5 +-- kuser/kgetcred.1 | 3 +- kuser/kinit.1 | 3 +- kuser/klist.1 | 5 +-- lib/krb5/kerberos.8 | 4 +- lib/krb5/krb5.conf.5 | 3 +- lib/krb5/krb5_425_conv_principal.3 | 2 +- lib/krb5/krb5_appdefault.3 | 11 ++--- lib/krb5/krb5_auth_context.3 | 2 +- lib/krb5/krb5_build_principal.3 | 2 +- lib/krb5/krb5_config.3 | 20 +++------ lib/krb5/krb5_free_principal.3 | 2 +- lib/krb5/krb5_parse_name.3 | 2 +- lib/krb5/krb5_sname_to_principal.3 | 2 +- lib/krb5/krb5_unparse_name.3 | 2 +- lib/krb5/verify_krb5_conf.8 | 3 +- tools/krb5-config.1 | 3 +- 33 files changed, 114 insertions(+), 161 deletions(-) diff --git a/admin/ktutil.8 b/admin/ktutil.8 index a30c4c1d5..5d4671f8c 100644 --- a/admin/ktutil.8 +++ b/admin/ktutil.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm ktutil -.Nd -manage Kerberos keytabs +.Nd manage Kerberos keytabs .Sh SYNOPSIS .Nm .Oo Fl k Ar keytab \*(Ba Xo diff --git a/appl/ftp/ftpd/ftpd.8 b/appl/ftp/ftpd/ftpd.8 index c27062a32..32d500269 100644 --- a/appl/ftp/ftpd/ftpd.8 +++ b/appl/ftp/ftpd/ftpd.8 @@ -38,8 +38,7 @@ .Os BSD 4.2 .Sh NAME .Nm ftpd -.Nd -Internet File Transfer Protocol server +.Nd Internet File Transfer Protocol server .Sh SYNOPSIS .Nm .Op Fl a Ar authmode diff --git a/appl/ftp/ftpd/ftpusers.5 b/appl/ftp/ftpd/ftpusers.5 index 607e50f6b..9336a9ce1 100644 --- a/appl/ftp/ftpd/ftpusers.5 +++ b/appl/ftp/ftpd/ftpusers.5 @@ -5,8 +5,7 @@ .Os KTH-KRB .Sh NAME .Pa /etc/ftpusers -.Nd -FTP access list file. +.Nd FTP access list file .Sh DESCRIPTION .Pa /etc/ftpusers contains a list of users that should be allowed or denied FTP diff --git a/appl/kf/kf.1 b/appl/kf/kf.1 index 27ca59f54..3836a0730 100644 --- a/appl/kf/kf.1 +++ b/appl/kf/kf.1 @@ -8,62 +8,54 @@ .Os Heimdal .Sh NAME .Nm kf -.Nd -securly forward tickets +.Nd securly forward tickets .Sh SYNOPSIS .Nm -.Oo Fl p Ar port \*(Ba Xo -.Fl -port= Ns Ar port Oc -.Xc -.Oo Fl l Ar login \*(Ba Xo -.Fl -login= Ns Ar login Oc -.Xc -.Oo Fl c Ar ccache \*(Ba Xo -.Fl -ccache= Ns Ar ccache Oc -.Xc -.Op Fl F | Fl -forwardable -.Op Fl G | Fl -no-forwardable -.Op Fl h | Fl -help +.Oo +.Fl p Ar port | +.Fl -port Ns = Ns Ar port +.Oc +.Oo +.Fl l Ar login | +.Fl -login Ns = Ns Ar login +.Oc +.Oo +.Fl c Ar ccache | +.Fl -ccache Ns = Ns Ar ccache +.Oc +.Op Fl F | -forwardable +.Op Fl G | -no-forwardable +.Op Fl h | -help .Op Fl -version .Ar host ... .Sh DESCRIPTION The .Nm program forwards tickets to a remove host through an authenticated -and encrypted stream. Options supported are: -.Bl -tag -width Ds +and encrypted stream. +Options supported are: +.Bl -tag -width indent .It Xo -.Fl p Ar port Ns , -.Fl -port= Ns Ar port +.Fl p Ar port , +.Fl -port Ns = Ns Ar port .Xc port to connect to .It Xo -.Fl l Ar login Ns , -.Fl -login= Ns Ar login +.Fl l Ar login , +.Fl -login Ns = Ns Ar login .Xc remote login name .It Xo -.Fl c Ar ccache Ns , -.Fl -ccache= Ns Ar ccache +.Fl c Ar ccache , +.Fl -ccache Ns = Ns Ar ccache .Xc remote cred cache -.It Xo -.Fl F Ns , -.Fl -forwardable -.Xc +.It Fl F , -forwardable forward forwardable credentials -.It Xo -.Fl G Ns , -.Fl -no-forwardable -.Xc +.It Fl G , -no-forwardable do not forward forwardable credentials -.It Xo -.Fl h Ns , -.Fl -help -.Xc -.It Xo -.Fl -version -.Xc +.It Fl h , -help +.It Fl -version .El .Pp .Nm @@ -83,9 +75,9 @@ is able to forward ticket by itself. .\".Sh EXAMPLES .\".Sh DIAGNOSTICS .Sh SEE ALSO -.Xr kfd 8 , .Xr kinit 1 , -.Xr telnet 1 +.Xr telnet 1 , +.Xr kfd 8 .\".Sh STANDARDS .\".Sh HISTORY .\".Sh AUTHORS diff --git a/appl/kf/kfd.8 b/appl/kf/kfd.8 index 3fca73bc9..c678c8dc6 100644 --- a/appl/kf/kfd.8 +++ b/appl/kf/kfd.8 @@ -8,33 +8,31 @@ .Os Heimdal .Sh NAME .Nm kfd -.Nd -receive forwarded tickets +.Nd receive forwarded tickets .Sh SYNOPSIS .Nm -.Oo Fl p Ar port \*(Ba Xo -.Fl -port= Ns Ar port Oc -.Xc -.Op Fl i | Fl -inetd -.Oo Fl R Ar regpag \*(Ba Xo -.Fl -regpag= Ns Ar regpag Oc -.Xc -.Op Fl h | Fl -help +.Oo +.Fl p Ar port | +.Fl -port Ns = Ns Ar port +.Oc +.Op Fl i | -inetd +.Oo +.Fl R Ar regpag | +.Fl -regpag Ns = Ns Ar regpag +.Oc +.Op Fl h | -help .Op Fl -version .Sh DESCRIPTION This is the daemon for -.Nm kf . +.Xr kf 1 . Supported options: -.Bl -tag -width Ds +.Bl -tag -width indent .It Xo -.Fl p Ar port Ns , -.Fl -port= Ns Ar port +.Fl p Ar port , +.Fl -port Ns = Ns Ar port .Xc port to listen to -.It Xo -.Fl i Ns , -.Fl -inetd -.Xc +.It Fl i , -inetd not started from inetd .It Xo .Fl R Ar regpag Ns , diff --git a/appl/push/pfrom.1 b/appl/push/pfrom.1 index 99759e19d..ca9eb6ae5 100644 --- a/appl/push/pfrom.1 +++ b/appl/push/pfrom.1 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm pfrom -.Nd -fetch a list of the current mail via POP +.Nd "fetch a list of the current mail via POP" .Sh SYNOPSIS .Nm .Op Fl 4 | Fl -krb4 diff --git a/appl/push/push.8 b/appl/push/push.8 index d3970575d..00c6f846c 100644 --- a/appl/push/push.8 +++ b/appl/push/push.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm push -.Nd -fetch mail via POP +.Nd fetch mail via POP .Sh SYNOPSIS .Nm .Op Fl 4 | Fl -krb4 @@ -16,9 +15,9 @@ fetch mail via POP .Op Fl l | -leave .Op Fl -from .Op Fl c | -count -.Op Fl -headers= Ns Ar headers +.Op Fl -headers Ns = Ns Ar headers .Oo Fl p Ar port-spec \*(Ba Xo -.Fl -port= Ns Ar port-spec +.Fl -port Ns = Ns Ar port-spec .Xc .Oc .Ar po-box @@ -81,12 +80,12 @@ behave like from. .Xc first print how many messages and bytes there are. .It Xo -.Fl -headers= Ns Ar headers +.Fl -headers Ns = Ns Ar headers .Xc a list of comma-separated headers that should get printed. .It Xo .Fl p Ar port-spec Ns , -.Fl -port= Ns Ar port-spec +.Fl -port Ns = Ns Ar port-spec .Xc use this port instead of the default .Ql kpop @@ -119,7 +118,7 @@ $ push --from -5 havregryn .Ed .Pp tries to fetch -.Nm From: +.Sy From: lines for current user at post office .Dq havregryn using Kerberos 5. diff --git a/kadmin/kadmin.8 b/kadmin/kadmin.8 index 64091c2f3..e25755454 100644 --- a/kadmin/kadmin.8 +++ b/kadmin/kadmin.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kadmin -.Nd -Kerberos administration utility +.Nd Kerberos administration utility .Sh SYNOPSIS .Nm .Oo Fl p Ar string \*(Ba Xo @@ -109,7 +108,7 @@ will prompt for commands to process. Commands include: .Op Fl -pw-expiration-time= Ns Ar time .Ar principal... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent creates a new principal .Ed .Pp @@ -122,21 +121,21 @@ creates a new principal .Op Fl -key= Ns Ar string .Ar principal... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent changes the password of an existing principal .Ed .Pp .Nm delete .Ar principal... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent removes a principal .Ed .Pp .Nm del_enctype .Ar principal enctypes... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent removes some enctypes from a principal, this can be useful the service belonging to the principal is known to not handle certain enctypes .Ed @@ -147,7 +146,7 @@ belonging to the principal is known to not handle certain enctypes .Xc .Ar principal... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent creates a keytab with the keys of the specified principals .Ed .Pp @@ -157,7 +156,7 @@ creates a keytab with the keys of the specified principals .Op Fl t | Fl -terse .Ar expression... .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent lists the principals that match the expressions (which are shell glob like), long format gives more information, and terse just prints the names @@ -166,7 +165,7 @@ names .Nm rename .Ar from to .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent renames a principal .Ed .Pp @@ -181,26 +180,25 @@ renames a principal .Op Fl -kvno= Ns Ar number .Ar principal .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent modifies certain attributes of a principal .Ed .Pp .Nm privileges .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent lists the operations you are allowd to perform .Ed .Pp .Ed - +.Pp When running in local mode, the following commands can also be used. - .Bd -ragged -offset indent .Nm dump .Op Fl d | Fl -decrypt .Op Ar dump-file .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent writes the database in .Dq human readable form to the specified file, or standard out @@ -211,7 +209,7 @@ form to the specified file, or standard out .Op Fl -realm-max-renewable-life= Ns Ar string .Ar realm .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent initialises the Kerberos database with entries for a new realm, it's possible to have more than one realm served by one server .Ed @@ -219,21 +217,20 @@ possible to have more than one realm served by one server .Nm load .Ar file .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent reads a previously dumped database, and re-creates that database from scratch .Ed .Pp .Nm merge .Ar file .Pp -.Bd -filled -offset indent +.Bd -ragged -offset indent similar to .Nm list but just modifies the database with the entries in the dump file .Ed .Pp .Ed - .\".Sh ENVIRONMENT .\".Sh FILES .\".Sh EXAMPLES diff --git a/kadmin/kadmind.8 b/kadmin/kadmind.8 index 67d5c9b5b..9b7668331 100644 --- a/kadmin/kadmind.8 +++ b/kadmin/kadmind.8 @@ -3,8 +3,7 @@ .Os HEIMDAL .Sh NAME .Nm kadmind -.Nd -server for administrative access to kerberos database +.Nd "server for administrative access to kerberos database" .Sh SYNOPSIS .Nm .Oo Fl c Ar file \*(Ba Xo @@ -32,7 +31,7 @@ connection. The option causes .Nm to accept exactly one connection, which is useful for debugging. - +.Pp If built with krb4 support, it implements both the Heimdal Kerberos 5 administrative protocol and the Kerberos 4 protocol. Password changes via the Kerberos 4 protocol are also performed by diff --git a/kdc/hprop.8 b/kdc/hprop.8 index 99f03b30a..9e2680cf3 100644 --- a/kdc/hprop.8 +++ b/kdc/hprop.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm hprop -.Nd -propagate the KDC database +.Nd propagate the KDC database .Sh SYNOPSIS .Nm .Oo Fl m Ar file \*(Ba Xo @@ -37,8 +36,8 @@ propagate the KDC database .Op Fl v | Fl -verbose .Op Fl -version .Op Fl h | Fl -help -.Ar host Ns Op :port -... +.Ar host Ns Op : Ns Ar port +.Ar ... .Sh DESCRIPTION .Nm takes a principal database in a specified format and converts it into @@ -112,7 +111,7 @@ This option thansmits the database with encrypted keys. .Xc Dump the database on stdout, in a format that can be fed to hpropd. .El - +.Pp The following options are only valid if .Nm hprop is compiled with support for Kerberos 4 (kaserver). @@ -145,7 +144,6 @@ Deprecated, identical to Deprecated, identical to .Sq --source=kaserver . .El - .Sh EXAMPLES The following will propagate a database to another machine (which should run @@ -153,12 +151,12 @@ should run .Bd -literal -offset indent $ hprop slave-1 slave-2 .Ed - +.Pp Copy a Kerberos 4 database to a Kerberos 5 slave: .Bd -literal -offset indent $ hprop --source=krb4-db -E krb5-slave .Ed - +.Pp Convert a Kerberos 4 dump-file for use with a Heimdal KDC: .Bd -literal -offset indent $ hprop -n --source=krb4-dump -d /var/kerberos/principal.dump -E | hpropd -n diff --git a/kdc/hpropd.8 b/kdc/hpropd.8 index 3fa283ac4..276977c63 100644 --- a/kdc/hpropd.8 +++ b/kdc/hpropd.8 @@ -1,12 +1,11 @@ .\" $Id$ .\" -.Dd Aug 27, 1997 +.Dd August 27, 1997 .Dt HPROPD 8 .Os HEIMDAL .Sh NAME .Nm hpropd -.Nd -receive a propagated database +.Nd receive a propagated database .Sh SYNOPSIS .Nm .Oo Fl d Ar file \*(Ba Xo diff --git a/kdc/kdc.8 b/kdc/kdc.8 index 67624d2fa..523f72005 100644 --- a/kdc/kdc.8 +++ b/kdc/kdc.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kdc -.Nd -Kerberos 5 server +.Nd Kerberos 5 server .Sh SYNOPSIS .Nm .Oo Fl c Ar file \*(Ba Xo diff --git a/kdc/kstash.8 b/kdc/kstash.8 index b87ec0cda..809440b5c 100644 --- a/kdc/kstash.8 +++ b/kdc/kstash.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kstash -.Nd -store the KDC master password in a file +.Nd "store the KDC master password in a file" .Sh SYNOPSIS .Nm .Oo Fl e Ar string \*(Ba Xo diff --git a/kdc/string2key.8 b/kdc/string2key.8 index 967a97192..5f6658a3a 100644 --- a/kdc/string2key.8 +++ b/kdc/string2key.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm string2key -.Nd -map a password into a key +.Nd map a password into a key .Sh SYNOPSIS .Nm .Op Fl 5 | Fl -version5 diff --git a/kpasswd/kpasswd.1 b/kpasswd/kpasswd.1 index 7440f0119..e6aec8267 100644 --- a/kpasswd/kpasswd.1 +++ b/kpasswd/kpasswd.1 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kpasswd -.Nd -Kerberos 5 password changing program +.Nd Kerberos 5 password changing program .Sh SYNOPSIS .Nm .Op Ar principal diff --git a/kpasswd/kpasswdd.8 b/kpasswd/kpasswdd.8 index 4fdc5df66..f0027001c 100644 --- a/kpasswd/kpasswdd.8 +++ b/kpasswd/kpasswdd.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kpasswdd -.Nd -Kerberos 5 password changing server +.Nd Kerberos 5 password changing server .Sh SYNOPSIS .Nm .Op Fl -check-library= Ns Ar library diff --git a/kuser/kdestroy.1 b/kuser/kdestroy.1 index d387c1c12..6313dd446 100644 --- a/kuser/kdestroy.1 +++ b/kuser/kdestroy.1 @@ -1,12 +1,11 @@ .\" $Id$ .\" -.Dd Aug 27, 1997 +.Dd August 27, 1997 .Dt KDESTROY 1 .Os HEIMDAL .Sh NAME .Nm kdestroy -.Nd -destroy the current ticket file +.Nd destroy the current ticket file .Sh SYNOPSIS .Nm .Op Fl c Ar cachefile diff --git a/kuser/kgetcred.1 b/kuser/kgetcred.1 index a6971854b..355a2204a 100644 --- a/kuser/kgetcred.1 +++ b/kuser/kgetcred.1 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm kgetcred -.Nd -get a ticket for a particular service +.Nd "get a ticket for a particular service" .Sh SYNOPSIS .Nm .Oo Fl e Ar enctype \*(Ba Xo diff --git a/kuser/kinit.1 b/kuser/kinit.1 index 3a276ed5f..16fdadc8e 100644 --- a/kuser/kinit.1 +++ b/kuser/kinit.1 @@ -6,8 +6,7 @@ .Sh NAME .Nm kinit , .Nm kauth -.Nd -acquire initial tickets +.Nd acquire initial tickets .Sh SYNOPSIS .Nm kinit .Op Fl 4 | Fl -524init diff --git a/kuser/klist.1 b/kuser/klist.1 index 307435147..81a121c24 100644 --- a/kuser/klist.1 +++ b/kuser/klist.1 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm klist -.Nd -list Kerberos credentials +.Nd list Kerberos credentials .Sh SYNOPSIS .Nm .Oo Fl c Ar cache \*(Ba Xo @@ -81,7 +80,7 @@ pre-authenticated .It H hardware authenticated .El - +.Pp This information is also output with the .Fl -verbose option, but in a more verbose way. diff --git a/lib/krb5/kerberos.8 b/lib/krb5/kerberos.8 index 7b12b0d21..3410bcf72 100644 --- a/lib/krb5/kerberos.8 +++ b/lib/krb5/kerberos.8 @@ -42,8 +42,8 @@ without giving your password. .Pp For more information on how Kerberos works, and other general Kerberos questions see the Kerberos FAQ at -.Ad http://www.nrl.navy.mil/CCS/people/kenh/kerberos-faq.html . - +.Pa http://www.nrl.navy.mil/CCS/people/kenh/kerberos-faq.html . +.Pp For setup instructions see the Heimdal Texinfo manual. .Sh SEE ALSO .Xr ftp 1 diff --git a/lib/krb5/krb5.conf.5 b/lib/krb5/krb5.conf.5 index 58fd750fd..632a4da97 100644 --- a/lib/krb5/krb5.conf.5 +++ b/lib/krb5/krb5.conf.5 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm /etc/krb5.conf -.Nd -Configuration file for Kerberos 5 +.Nd configuration file for Kerberos 5 .Sh DESCRIPTION The .Nm diff --git a/lib/krb5/krb5_425_conv_principal.3 b/lib/krb5/krb5_425_conv_principal.3 index 6c5d6e60c..e24049ea5 100644 --- a/lib/krb5/krb5_425_conv_principal.3 +++ b/lib/krb5/krb5_425_conv_principal.3 @@ -7,7 +7,7 @@ .Nm krb5_425_conv_principal , .Nm krb5_425_conv_principal_ext , .Nm krb5_524_conv_principal -.Nd Converts to and from version 4 principals +.Nd converts to and from version 4 principals .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/krb5_appdefault.3 b/lib/krb5/krb5_appdefault.3 index 3594da546..71e65ede9 100644 --- a/lib/krb5/krb5_appdefault.3 +++ b/lib/krb5/krb5_appdefault.3 @@ -7,27 +7,23 @@ .Nm krb5_appdefault_boolean , .Nm krb5_appdefault_string , .Nm krb5_appdefault_time -.Nd Get application configuration value - +.Nd get application configuration value .Sh SYNOPSIS .Fd #include - .Ft void .Fn krb5_appdefault_boolean "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "krb5_boolean def_val" "krb5_boolean *ret_val" .Ft void .Fn krb5_appdefault_string "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "const char *def_val" "char **ret_val" .Ft void .Fn krb5_appdefault_time "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "time_t def_val" "time_t *ret_val" - .Sh DESCRIPTION - These functions get application application defaults from the .Dv appdefaults section of the .Xr krb5.conf 5 configuration file. These defaults can be specified per application, and/or per realm. - +.Pp These values will be looked for in .Xr krb5.conf 5 , in order of descending importance. @@ -46,12 +42,11 @@ in order of descending importance. } option = value .Ed - +.Pp If the realm is omitted it will not be used for resolving values. If no value can be found, .Fa def_val is returned instead. - .Sh SEE ALSO .Xr krb5_config 3 , .Xr krb5.conf 5 diff --git a/lib/krb5/krb5_auth_context.3 b/lib/krb5/krb5_auth_context.3 index f568b0f16..b14b8d4de 100644 --- a/lib/krb5/krb5_auth_context.3 +++ b/lib/krb5/krb5_auth_context.3 @@ -34,7 +34,7 @@ .Nm krb5_auth_con_setrcache , .Nm krb5_auth_con_initivector , .Nm krb5_auth_con_setivector -.Nd manage authetication on connection level. +.Nd manage authetication on connection level .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/krb5_build_principal.3 b/lib/krb5/krb5_build_principal.3 index f49b05416..ebc6a05ac 100644 --- a/lib/krb5/krb5_build_principal.3 +++ b/lib/krb5/krb5_build_principal.3 @@ -9,7 +9,7 @@ .Nm krb5_build_principal_va , .Nm krb5_build_principal_va_ext , .Nm krb5_make_principal -.Nd Principal creation functions +.Nd principal creation functions .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/krb5_config.3 b/lib/krb5/krb5_config.3 index c500e5569..a27ee6e63 100644 --- a/lib/krb5/krb5_config.3 +++ b/lib/krb5/krb5_config.3 @@ -8,11 +8,9 @@ .Nm krb5_config_get_int_default , .Nm krb5_config_get_string_default , .Nm krb5_config_get_time_default -.Nd Get configuration value - +.Nd get configuration value .Sh SYNOPSIS .Fd #include - .Ft krb5_boolean .Fn krb5_config_get_bool_default "krb5_context context" "krb5_config_section *c" "krb5_boolean def_value" "..." .Ft int @@ -21,27 +19,24 @@ .Fn krb5_config_get_string_default "krb5_context context" "krb5_config_section *c" "const char *def_value" "..." .Ft int .Fn krb5_config_get_time_default "krb5_context context" "krb5_config_section *c" "int def_value" "..." - .Sh DESCRIPTION - These functions get values from the .Xr krb5.conf 5 configuration file, or another configuration database specified by the .Fa c parameter. - +.Pp The variable arguments should be a list of strings naming each subsection to look for. For example: - .Bd -literal -offset indent krb5_config_get_bool_default(context, NULL, FALSE, "libdefaults", "log_utc", NULL) .Ed - +.Pp gets the boolean value for the .Dv log_utc option, defaulting to .Dv FALSE . - +.Pp .Fn krb5_config_get_bool_default will convert the option value to a boolean value, where .Sq yes , @@ -50,22 +45,19 @@ and any non-zero number means .Dv TRUE , and any other value .Dv FALSE . - +.Pp .Fn krb5_config_get_int_default will convert the value to an integer. - +.Pp .Fn krb5_config_get_time_default will convert the value to a period of time (not a time stamp) in seconds, so the string .Sq 2 weeks will be converted to 1209600 (2 * 7 * 24 * 60 * 60). - .Sh BUGS - Other than for the string case, there's no way to tell whether there was a value specified or not. - .Sh SEE ALSO .Xr krb5_appdefault 3 , .Xr krb5.conf 5 diff --git a/lib/krb5/krb5_free_principal.3 b/lib/krb5/krb5_free_principal.3 index ae35d812b..7ae261bcc 100644 --- a/lib/krb5/krb5_free_principal.3 +++ b/lib/krb5/krb5_free_principal.3 @@ -5,7 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm krb5_free_principal -.Nd Principal free function +.Nd principal free function .Sh SYNOPSIS .Fd #include .Ft void diff --git a/lib/krb5/krb5_parse_name.3 b/lib/krb5/krb5_parse_name.3 index 66377a350..302fe1228 100644 --- a/lib/krb5/krb5_parse_name.3 +++ b/lib/krb5/krb5_parse_name.3 @@ -5,7 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm krb5_parse_name -.Nd String to principal conversion +.Nd string to principal conversion .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/krb5_sname_to_principal.3 b/lib/krb5/krb5_sname_to_principal.3 index 336a6a3b1..38fed6d3d 100644 --- a/lib/krb5/krb5_sname_to_principal.3 +++ b/lib/krb5/krb5_sname_to_principal.3 @@ -6,7 +6,7 @@ .Sh NAME .Nm krb5_sname_to_principal , .Nm krb5_sock_to_principal -.Nd Create a service principal +.Nd create a service principal .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/krb5_unparse_name.3 b/lib/krb5/krb5_unparse_name.3 index c949ea212..4b13b9e51 100644 --- a/lib/krb5/krb5_unparse_name.3 +++ b/lib/krb5/krb5_unparse_name.3 @@ -6,7 +6,7 @@ .Sh NAME .Nm krb5_unparse_name .\" .Nm krb5_unparse_name_ext -.Nd Principal to string conversion +.Nd principal to string conversion .Sh SYNOPSIS .Fd #include .Ft krb5_error_code diff --git a/lib/krb5/verify_krb5_conf.8 b/lib/krb5/verify_krb5_conf.8 index 15a5eb986..aa15fe702 100644 --- a/lib/krb5/verify_krb5_conf.8 +++ b/lib/krb5/verify_krb5_conf.8 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm verify_krb5_conf -.Nd -does a crude test that +.Nd does a crude test that .Pa krb5.conf does not contain any obvious syntax error .Sh SYNOPSIS diff --git a/tools/krb5-config.1 b/tools/krb5-config.1 index cf71f2cf6..3714061b8 100644 --- a/tools/krb5-config.1 +++ b/tools/krb5-config.1 @@ -5,8 +5,7 @@ .Os HEIMDAL .Sh NAME .Nm krb5-config -.Nd -give information on how to link code against Heimdal libraries +.Nd "give information on how to link code against Heimdal libraries" .Sh SYNOPSIS .Nm .Op Fl -prefix Ns Op = Ns Ar dir