x
[heimdal.git] / kpasswd / kpasswdd.8
blob3cb592053fd26c8cd412d48b6f3a5deb973b4be5
1 .\" $Id$
2 .\"
3 .Dd April 19, 1999
4 .Dt KPASSWDD 8
5 .Os HEIMDAL
6 .Sh NAME
7 .Nm kpasswdd
8 .Nd Kerberos 5 password changing server
9 .Sh SYNOPSIS
10 .Nm
11 .Bk -words
12 .Op Fl -addresses= Ns Ar address
13 .Op Fl -check-library= Ns Ar library
14 .Op Fl -check-function= Ns Ar function
15 .Oo Fl k Ar kspec \*(Ba Xo
16 .Fl -keytab= Ns Ar kspec
17 .Xc
18 .Oc
19 .Oo Fl r Ar realm \*(Ba Xo
20 .Fl -realm= Ns Ar realm
21 .Xc
22 .Oc
23 .Oo Fl p Ar string \*(Ba Xo
24 .Fl -port= Ns Ar string
25 .Xc
26 .Oc
27 .Op Fl -version
28 .Op Fl -help
29 .Ek
30 .Sh DESCRIPTION
31 .Nm
32 serves request for password changes. It listens on UDP port 464
33 (service kpasswd) and processes requests when they arrive. It changes
34 the database directly and should thus only run on the master KDC.
35 .Pp
36 Supported options:
37 .Bl -tag -width Ds
38 .It Xo
39 .Fl -addresses= Ns Ar address
40 .Xc
41 For each till the argument is given, add the address to what kpasswdd
42 should listen too.
43 .It Xo
44 .Fl -check-library= Ns Ar library
45 .Xc
46 If your system has support for dynamic loading of shared libraries,
47 you can use an external function to check password quality. This
48 option specifies which library to load.
49 .It Xo
50 .Fl -check-function= Ns Ar function
51 .Xc
52 This is the function to call in the loaded library. The function
53 should look like this:
54 .Pp
55 .Ft const char *
56 .Fn passwd_check "krb5_context context" "krb5_principal principal" "krb5_data *password"
57 .Pp
58 .Fa context
59 is an initialized context;
60 .Fa principal
61 is the one who tries to change passwords, and
62 .Fa password
63 is the new password. Note that the password (in
64 .Fa password->data )
65 is not zero terminated.
66 .It Xo
67 .Fl k Ar kspec ,
68 .Fl -keytab= Ns Ar kspec
69 .Xc
70 Keytab to get authentication key from.
71 .It Xo
72 .Fl r Ar realm ,
73 .Fl -realm= Ns Ar realm
74 .Xc
75 Default realm.
76 .It Xo
77 .Fl p Ar string ,
78 .Fl -port= Ns Ar string
79 .Xc
80 Port to listen on (default service kpasswd - 464).
81 .El
82 .Sh DIAGNOSTICS
83 If an error occurs, the error message is returned to the user and/or
84 logged to syslog.
85 .Sh BUGS
86 The default password quality checks are too basic.
87 .Sh SEE ALSO
88 .Xr kpasswd 1 ,
89 .Xr kdc 8
90 .\".Sh ENVIRONMENT
91 .\".Sh FILES
92 .\".Sh EXAMPLES
93 .\".Sh SEE ALSO
94 .\".Sh STANDARDS
95 .\".Sh HISTORY
96 .\".Sh AUTHORS