Module Name: src Committed By: wiz Date: Sat Feb 12 15:58:03 UTC 2011
Modified Files: src/crypto/external/bsd/libsaslc/dist/man: libsaslc.3 Log Message: Remove trailing whitespace and superfluous Pp before new sections. Use Nm instead of Xr'ing itself. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3 diff -u src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3:1.4 src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3:1.5 --- src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3:1.4 Fri Feb 11 23:44:42 2011 +++ src/crypto/external/bsd/libsaslc/dist/man/libsaslc.3 Sat Feb 12 15:58:03 2011 @@ -1,4 +1,4 @@ -.\" $NetBSD: libsaslc.3,v 1.4 2011/02/11 23:44:42 christos Exp $ +.\" $NetBSD: libsaslc.3,v 1.5 2011/02/12 15:58:03 wiz Exp $ .\" .\" Copyright (c) 2010 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -57,35 +57,35 @@ .Sh SYNOPSIS .In saslc.h .Ft saslc_t * -.Fn saslc_alloc "void" +.Fn saslc_alloc "void" .Ft int .Fn saslc_end "saslc_t *ctx" .Ft int .Fn saslc_init "saslc_t *ctx" "const char *appname" "const char *cfgpath" .Ft int .Fn saslc_sess_cont "saslc_sess_t *sess" "const void *in" "size_t inlen" \ -"void* *out" "size_t *outlen" +"void* *out" "size_t *outlen" .Ft ssize_t .Fn saslc_sess_decode "saslc_sess_t *sess" "const void *in" "size_t inlen" \ -"void* *out" "size_t *outlen" +"void* *out" "size_t *outlen" .Ft ssize_t .Fn saslc_sess_encode "saslc_sess_t *sess" "const void *in" "size_t inlen" \ -"void* *out" "size_t *outlen" +"void* *out" "size_t *outlen" .Ft void -.Fn saslc_sess_end "saslc_sess_t *sess" +.Fn saslc_sess_end "saslc_sess_t *sess" .Ft const char * .Fn saslc_sess_getmech "saslc_sess_t *" .Ft const char * -.Fn saslc_sess_getprop "saslc_sess_t *sess" "const char *key" +.Fn saslc_sess_getprop "saslc_sess_t *sess" "const char *key" .Ft saslc_sess_t * .Fn saslc_sess_init "saslc_t *ctx" "const char *mechs" "const char *secopts" .Ft int .Fn saslc_sess_setprop "saslc_sess_t *sess" "const char *key" \ "const char *value" .Ft const char * -.Fn saslc_sess_strerror "saslc_sess_t *sess" +.Fn saslc_sess_strerror "saslc_sess_t *sess" .Ft const char * -.Fn saslc_strerror "saslc_t *ctx" +.Fn saslc_strerror "saslc_t *ctx" .Sh DESCRIPTION The .Fn saslc_alloc @@ -174,7 +174,7 @@ function sets the property indexed by .Ar key to the value -.Ar value +.Ar value in the session .Ar sess dictionary. @@ -214,7 +214,7 @@ buffer and stores .Ar outlen bytes of output data in -.Ar out +.Ar out .Pq for the server . The user is responsible for freeing memory allocated for .Ar out . @@ -257,7 +257,7 @@ with .Ar inlen = 0. -In this case, +In this case, .Fn saslc_sess_encode returns the number of bytes that were flushed from the internal buffer. .Pp @@ -349,9 +349,8 @@ return 0; } .Ed -.Pp .Sh CONFIGURATION -.Xr libsaslc 3 +.Nm uses three types of dictionaries: context (or global), session, and mechanism, and they are searched in that order by .Fn saslc_getprop @@ -440,10 +439,9 @@ Any base supported by .Xr strtoll 3 is allowed. -.Pp .Sh PROPERTIES Most of the control of the -.Xr libsaslc 3 +.Nm behavior is done via setting various properties in the context or mechanism dictionaries via the configuration files or in the session dictionary with @@ -567,12 +565,11 @@ .Pa saslc.h should be used in code, but their values need to be used in the config files. -.Pp .Sh ENVIRONMENT The following environment variables .Pq defined in Pa saslc.h affect the behavior of -.Xr libsaslc 3 : +.Nm : .Bl -tag -width indent .It Ev SASLC_ENV_CONFIG Po Qo SASLC_CONFIG Qc Pc If the environment variable @@ -674,7 +671,7 @@ .Pa /etc/krb5.keytab . Setup the .Pa /etc/saslc.d -configuration directory +configuration directory .Pq see CONFIGURATION above . Add the line .Bd -literal -offset indent @@ -694,7 +691,7 @@ .Pa /etc/postfix/main.cf file to do this: .Bd -literal -offset indent -smtp_sasl_auth_enable = yes +smtp_sasl_auth_enable = yes smtp_sasl_type = saslc smtp_sasl_mechanism_filter = GSSAPI relayhost = [server.my.domain]:submission @@ -712,7 +709,6 @@ .Pp to obtain a ticket for the postfix user with the postfix credential and you should be good to go! -.Pp .Sh STANDARDS RFC 2195, RFC 2222, RFC 2245, RFC 2595, RFC 2831, RFC 4422, RFC 4505, RFC 4616, RFC 4752.