php man page for kadm5_create_principal

KADM5_CREATE_PRINCIPAL(3)						 1						 KADM5_CREATE_PRINCIPAL(3)

kadm5_create_principal - Creates a kerberos principal with the given parameters

SYNOPSIS
       bool kadm5_create_principal (resource  $handle, string  $principal, [string  $password], [array	$options])

DESCRIPTION
	Creates a $principal with the given $password.

PARAMETERS
	      o $handle
		- A KADM5 handle.

	      o $principal
		- The principal.

	      o $password
		- If $password is omitted or is NULL, a random key will be generated.

	      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.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

EXAMPLES
       Example #1

	      Example of principal's creation

	      <?php

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

	      $attributes = KRB5_KDB_REQUIRES_PRE_AUTH | KRB5_KDB_DISALLOW_PROXIABLE;
	      $options = array(KADM5_PRINC_EXPIRE_TIME => 0,
			       KADM5_POLICY => "default",
			       KADM5_ATTRIBUTES => $attributes);

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

	      kadm5_destroy($handle);
	      ?>

SEE ALSO
       kadm5_modify_principal(3), kadm5_delete_principal(3).

PHP Documentation Group 												 KADM5_CREATE_PRINCIPAL(3)