KADM5_MODIFY_PRINCIPAL(3)						 1						 KADM5_MODIFY_PRINCIPAL(3)

kadm5_modify_principal - Modifies a kerberos principal with the given parameters

SYNOPSIS

       bool kadm5_modify_principal (resource  $handle, string  $principal, array  $options)

DESCRIPTION

	Modifies a $principal according to the given $options.

PARAMETERS

	      o $handle
		- A KADM5 handle.

	      o $principal
		- The principal.

	      o $options
		-  It  is  possible  to  specify  several  optional  parameters  within  the  array  $options.	Allowed are the following options:
		KADM5_PRINC_EXPIRE_TIME,  KADM5_PW_EXPIRATION,	KADM5_ATTRIBUTES,  KADM5_MAX_LIFE,  KADM5_KVNO,  KADM5_POLICY,	KADM5_CLEARPOLICY,
		KADM5_MAX_RLIFE.  KADM5_FAIL_AUTH_COUNT.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Example of modifying principal

	      <?php

	      $handle = kadm5_init_with_password("afs-1", "GONICUS.LOCAL", "admin/admin", "password");

	      $attributes = KRB5_KDB_REQUIRES_PRE_AUTH;
	      $options = array(KADM5_PRINC_EXPIRE_TIME => 3451234,
			       KADM5_POLICY => "gonicus",
			       KADM5_ATTRIBUTES => $attributes);

	      kadm5_modify_principal($handle, "burbach@GONICUS.LOCAL", $options);

	      kadm5_destroy($handle);
	      ?>

SEE ALSO

       kadm5_create_principal(3), kadm5_delete_principal(3).

PHP Documentation Group 												 KADM5_MODIFY_PRINCIPAL(3)