File: pod.patch

package info (click to toggle)
libauthen-krb5-admin-perl 0.17-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 496 kB
  • sloc: perl: 737; ansic: 242; makefile: 7
file content (383 lines) | stat: -rw-r--r-- 11,968 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
Description: bullet after =item is not allowed anymore
Origin: vendor
Bug: https://rt.cpan.org/Ticket/Display.html?id=88281
Forwarded: https://rt.cpan.org/Ticket/Display.html?id=88281
Author: gregor herrmann <gregoa@debian.org>
Last-Update: 2013-08-30

--- a/Admin.pm
+++ b/Admin.pm
@@ -313,27 +313,27 @@
 The only methods in this class are the constructor (I<new>, described
 above) and the following accessor methods.
 
-=item * admin_server {KADM5_CONFIG_ADMIN_SERVER}
+=item admin_server {KADM5_CONFIG_ADMIN_SERVER}
 
 Admin server hostname
 
-=item * kadmind_port {KADM5_CONFIG_KADMIND_PORT}
+=item kadmind_port {KADM5_CONFIG_KADMIND_PORT}
 
 Admin server port number
 
-=item * kpasswd_port {KADM5_CONFIG_KPASSWD_PORT}
+=item kpasswd_port {KADM5_CONFIG_KPASSWD_PORT}
 
 Kpasswd server port number
 
-=item * mask
+=item mask
 
 Mask (described above)
 
-=item * profile {KADM5_CONFIG_PROFILE}
+=item profile {KADM5_CONFIG_PROFILE}
 
 Kerberos 5 configuration profile
 
-=item * realm {KADM5_CONFIG_REALM}
+=item realm {KADM5_CONFIG_REALM}
 
 Kerberos 5 realm name
 
@@ -343,32 +343,32 @@
 The only methods in this class are the constructor (I<new>, described
 above) and the following accessor methods.
 
-=item * key_contents
+=item key_contents
 
 Key contents, encrypted with the KDC master key.  This data may not be
 available remotely.
 
-=item * enc_type
+=item enc_type
 
 Kerberos 5 enctype of the key
 
-=item * key_type
+=item key_type
 
 Alias for I<enc_type>
 
-=item * kvno
+=item kvno
 
 Key version number
 
-=item * salt_contents
+=item salt_contents
 
 Salt contents, if any (I<ver> > 1)
 
-=item * salt_type
+=item salt_type
 
 Salt type, if any (I<ver> > 1)
 
-=item * ver
+=item ver
 
 Version number of the underlying I<krb5_key_data> structure
 
@@ -378,53 +378,53 @@
 are the constructor (I<new>, described above) and the following
 accessor methods.
 
-=item * mask
+=item mask
 
 Mask (described above)
 
-=item * name {KADM5_POLICY}
+=item name {KADM5_POLICY}
 
 Policy name
 
-=item * pw_history_num {KADM5_PW_HISTORY_NUM}
+=item pw_history_num {KADM5_PW_HISTORY_NUM}
 
 Number (between 1 and 10, inclusive) of past passwords to be stored
 for the principal.  A principal may not set its password to any of its
 previous I<pw_history_num> passwords.
 
-=item * pw_max_life {KADM5_PW_MAX_LIFE}
+=item pw_max_life {KADM5_PW_MAX_LIFE}
 
 Default number of seconds a password lasts before the principal is
 required to change it
 
-=item * pw_max_fail {KADM5_PW_MAX_FAILURE}
+=item pw_max_fail {KADM5_PW_MAX_FAILURE}
 
 The maximum allowed number of attempts before a lockout.
 
-=item * pw_failcnt_interval {KADM5_PW_FAILURE_COUNT_INTERVAL}
+=item pw_failcnt_interval {KADM5_PW_FAILURE_COUNT_INTERVAL}
 
 The period after which the bad preauthentication count will be reset.
 
-=item * pw_lockout_duration {KADM5_PW_LOCKOUT_DURATION}
+=item pw_lockout_duration {KADM5_PW_LOCKOUT_DURATION}
 
 The period in which lockout is enforced; a duration of zero means that
 the principal must be manually unlocked.
 
-=item * pw_min_classes {KADM5_PW_MIN_CLASSES}
+=item pw_min_classes {KADM5_PW_MIN_CLASSES}
 
 Number (between 1 and 5, inclusive) of required character classes
 represented in a password
 
-=item * pw_min_length {KADM5_PW_MIN_LENGTH}
+=item pw_min_length {KADM5_PW_MIN_LENGTH}
 
 Minimum number of characters in a password
 
-=item * pw_min_life {KADM5_PW_MIN_LIFE}
+=item pw_min_life {KADM5_PW_MIN_LIFE}
 
 Number of seconds a password must age before the principal may change
 it
 
-=item * policy_refcnt {KADM5_REF_COUNT}
+=item policy_refcnt {KADM5_REF_COUNT}
 
 Number of principals referring to this policy (read-only, does not set
 KADM5_REF_COUNT automatically)
@@ -439,95 +439,95 @@
 above), the following accessor methods, and I<policy_clear>, which is
 used to clear the policy attribute.
 
-=item * attributes {KADM5_ATTRIBUTES}
+=item attributes {KADM5_ATTRIBUTES}
 
 Bitfield representing principal attributes (see L<kadmin(8)>)
 
-=item * aux_attributes {KADM5_AUX_ATTRIBUTES}
+=item aux_attributes {KADM5_AUX_ATTRIBUTES}
 
 Bitfield used by kadmin.  Currently only recognizes the KADM5_POLICY,
 which indicates that a policy is in effect for this principal.  This
 attribute is read-only, so KADM5_AUX_ATTRIBUTES is not set
 automatically.
 
-=item * fail_auth_count {KADM5_FAIL_AUTH_COUNT}
+=item fail_auth_count {KADM5_FAIL_AUTH_COUNT}
 
 Number of consecutive failed AS_REQs for this principal.  This
 attribute is read-only, so KADM5_FAIL_AUTH_COUNT is not set
 automatically.
 
-=item * kvno {KADM5_KVNO}
+=item kvno {KADM5_KVNO}
 
 Key version number
 
-=item * last_failed {KADM5_LAST_FAILED}
+=item last_failed {KADM5_LAST_FAILED}
 
 Time (in seconds since the Epoch) of the last failed AS_REQ for this
 principal.  This attribute is read-only, so KADM5_LAST_FAILED is not
 set automatically.
 
-=item * last_pwd_change {KADM5_LAST_PWD_CHANGE}
+=item last_pwd_change {KADM5_LAST_PWD_CHANGE}
 
 Time (in seconds since the Epoch) of the last password change for this
 principal.  This attribute is read-only, so KADM5_LAST_PWD_CHANGE is
 not set automatically.
 
-=item * last_success {KADM5_LAST_SUCCESS}
+=item last_success {KADM5_LAST_SUCCESS}
 
 Time (in seconds since the Epoch) of the last successful AS_REQ for
 this principal.  This attribute is read-only, so KADM5_LAST_SUCCESS is
 not set automatically.
 
-=item * mask
+=item mask
 
 Mask (see above)
 
-=item * max_life {KADM5_MAX_LIFE}
+=item max_life {KADM5_MAX_LIFE}
 
 maximum lifetime in seconds of any Kerberos ticket issued to this
 principal
 
-=item * max_renewable_life {KADM5_MAX_RLIFE}
+=item max_renewable_life {KADM5_MAX_RLIFE}
 
 maximum renewable lifetime in seconds of any Kerberos ticket issued to
 this principal
 
-=item * mod_date {KADM5_MOD_TIME}
+=item mod_date {KADM5_MOD_TIME}
 
 Time (in seconds since the Epoch) this principal was last modified.
 This attribute is read-only, so KADM5_MOD_TIME is not set
 automatically.
 
-=item * mod_name {KADM5_MOD_NAME}
+=item mod_name {KADM5_MOD_NAME}
 
 Kerberos principal (B<Authen::Krb5::Principal>, see
 L<Authen::Krb5(3)>) that last modified this principal.  This attribute
 is read-only, so KADM5_MOD_NAME is not set automatically.
 
-=item * policy {KADM5_POLICY}
+=item policy {KADM5_POLICY}
 
 Name of policy that affects this principal if KADM5_POLICY is set in
 I<aux_attributes>
 
-=item * policy_clear {KADM5_POLICY_CLR}
+=item policy_clear {KADM5_POLICY_CLR}
 
 Not really an attribute--disables the current policy for this
 principal.  This method doesn't return anything.
 
-=item * princ_expire_time {KADM5_PRINC_EXPIRE_TIME}
+=item princ_expire_time {KADM5_PRINC_EXPIRE_TIME}
 
 Expire time (in seconds since the Epoch) of the principal
 
-=item * principal {KADM5_PRINCIPAL}
+=item principal {KADM5_PRINCIPAL}
 
 Kerberos principal itself (B<Authen::Krb5::Principal>, see
 L<Authen::Krb5(3)>)
 
-=item * pw_expiration {KADM5_PW_EXPIRATION}
+=item pw_expiration {KADM5_PW_EXPIRATION}
 
 Expire time (in seconds since the Epoch) of the principal's password
 
-=item * db_args [@ARGS]
+=item db_args [@ARGS]
 
 When called without any C<@ARGS>, returns the list of arguments that
 will be passed into the underlying database, as with C<addprinc -x> in
@@ -578,82 +578,82 @@
 the configuration from the Kerberos 5 profile (F</etc/krb5.conf> by
 default).
 
-=item * $kadm5 =  Authen::Krb5::Admin->init_with_creds($client, $krb5_ccache[, $service, $kadm5_config])
+=item $kadm5 =  Authen::Krb5::Admin->init_with_creds($client, $krb5_ccache[, $service, $kadm5_config])
 
 Authenticate using the credentials cached in $krb5_ccache.
 
-=item * $kadm5 = Authen::Krb5::Admin->init_with_password($client[, $password, $service, $kadm5_config])
+=item $kadm5 = Authen::Krb5::Admin->init_with_password($client[, $password, $service, $kadm5_config])
 
 Authenticate with $password.
 
-=item * $kadm5 = Authen::Krb5::Admin->init_with_skey($client[, $keytab_file, $service, $kadm5_config])
+=item $kadm5 = Authen::Krb5::Admin->init_with_skey($client[, $keytab_file, $service, $kadm5_config])
 
 Authenticate using the keytab stored in $keytab_file.  If $keytab_file
 is undef, the default keytab is used.
 
 =item Principal Operations
 
-=item * $success = $kadm5->chpass_principal($krb5_princ, $password)
+=item $success = $kadm5->chpass_principal($krb5_princ, $password)
 
 Change the password of $krb5_princ to $password.
 
-=item * $success = $kadm5->create_principal($kadm5_princ[, $password])
+=item $success = $kadm5->create_principal($kadm5_princ[, $password])
 
 Insert $kadm5_princ into the database, optionally setting its password
 to the string in $password.  Clears KADM5_POLICY_CLR and
 KADM5_FAIL_AUTH_COUNT.
 
-=item * $success = $kadm5->delete_principal($krb5_princ)
+=item $success = $kadm5->delete_principal($krb5_princ)
 
 Delete the principal represented by $krb5_princ from the database.
 
-=item * $kadm5_princ = $kadm5->get_principal($krb5_princ[, $mask])
+=item $kadm5_princ = $kadm5->get_principal($krb5_princ[, $mask])
 
 Retrieve the Authen::Krb5::Admin::Principal object for the principal
 $krb5_princ from the database.  Use KADM5_PRINCIPAL_NORMAL_MASK to
 retrieve all of the useful attributes.
 
-=item * @names = $kadm5->get_principals([$expr])
+=item @names = $kadm5->get_principals([$expr])
 
 Retrieve a list of principal names matching the glob pattern $expr.
 In the absence of $expr, retrieve the list of all principal names.
 
-=item * $success = $kadm5->modify_principal($kadm5_princ)
+=item $success = $kadm5->modify_principal($kadm5_princ)
 
 Modify $kadm5_princ in the database.  The principal to modify is
 determined by C<$kadm5_princ-E<gt>principal>, and the rest of the writable
 parameters will be modified accordingly.  Clears KADM5_PRINCIPAL.
 
-=item * @keys = $kadm5->randkey_principal($krb5_princ)
+=item @keys = $kadm5->randkey_principal($krb5_princ)
 
 Randomize the principal in the database represented by $krb5_princ and
 return B<Authen::Krb5::Keyblock> objects.
 
-=item * $success = $kadm5->rename_principal($krb5_princ_from, $krb5_princ_to)
+=item $success = $kadm5->rename_principal($krb5_princ_from, $krb5_princ_to)
 
 Change the name of the principal from $krb5_princ_from to $krb5_princ_to.
 
 =item Policy Operations
 
-=item * $success = $kadm5->create_policy($kadm5_pol)
+=item $success = $kadm5->create_policy($kadm5_pol)
 
 Insert $kadm5_pol into the database.
 
-=item * $success = $kadm5->delete_policy($name)
+=item $success = $kadm5->delete_policy($name)
 
 Delete the policy named $name from the database.
 
-=item * $kadm5_pol = $kadm5->get_policy([$name])
+=item $kadm5_pol = $kadm5->get_policy([$name])
 
 Retrieve the B<Authen::Krb5::Admin::Policy> object for the policy
 named $name from the database.
 
-=item * @names = $kadm5->get_policies([$expr])
+=item @names = $kadm5->get_policies([$expr])
 
 Retrieve a list of policy names matching the glob pattern $expr.  In
 the absence of $expr, retrieve the list of all policy names.
 
-=item * $success = $kadm5->modify_policy($kadm5_pol)
+=item $success = $kadm5->modify_policy($kadm5_pol)
 
 Modify $kadm5_pol in the database.  The policy to modify is
 determined by C<$kadm5_pol->name>,(and the rest of the writable)
@@ -661,18 +661,18 @@
 
 =item Other Methods
 
-=item * $magic_value = Authen::Krb5::Admin::error [$error]
+=item $magic_value = Authen::Krb5::Admin::error [$error]
 
 Return value that acts like $! (see L<perlvar(1)>) for the most
 recent Authen::Krb5::Admin call.  With error code $error, return
 the error message corresponding to that error code.
 
-=item * $error_code = Authen::Krb5::Admin::error_code
+=item $error_code = Authen::Krb5::Admin::error_code
 
 Returns the value of the error code for the most recent
 Authen::Krb5::Admin call as a simple integer.
 
-=item * $privs = $kadm5->get_privs
+=item $privs = $kadm5->get_privs
 
 Return a bitfield representing the kadmin privileges a principal has,
 as follows: