NAME
env_list_strings - return names and values of all the string variables
env_list_ports - return names and value of all port variables
env_set_stlist - set a number of string variables
env_set_ptlist - set a number of port variables

SYNOPSIS
#include <servers/env_mgr.h>

kern_return_t env_list_strings(env_port,env_names,name_cnt,
env_string_vals,string_cnt)
port_t env_port;
env_name_list *env_names
int *name_cnt;
env_str_list *env_string_vals;
int *string_cnt);

kern_return_t env_list_ports(env_port,env_names,name_cnt,
env_port_vals,port_cnt)
port_t env_port;
env_name_list *env_names
int *name_cnt;
port_array_t *env_port_vals;
int *port_cnt);

kern_return_t env_set_stlist(env_port,env_names,name_cntf,
env_string_vals,string_cnt)
port_t env_port;
env_name_list env_names
int name_cnt;
env_str_list env_string_vals;
int string_cnt);

kern_return_t env_set_ptlist(env_port,env_names,name_cnt,
env_port_vals,port_cnt)
port_t env_port;
env_name_list env_names;
int name_cnt;
port_array_t env_port_vals;
int port_cnt);

ARGUMENTS
env_port port identifying environment

env_names pointer to list of names of all string variables

name_cnt number of names

env_string_vals
pointer to values of string variables (for
env_list_strings ) list of values of string
variables ( for env_set_stlist )

string_cnt number of string values (equal to name_cnt )

env_port_vals pointer to values of port variables (for
env_list_ports ) list of values of port variables
(for env_set_ptlist )

port_cnt number of port values (equal to name_cnt )

DESCRIPTION
env_list_string returns a complete list of all the string variables
in the environment specified by env_port env_names and
env_string_vals are returned in newly allocated virtual memory.
This memory should be released by a call to vm_deallocate once the
items are no longer needed.

env_list_ports returns a complete list of all the port variables in
the environment specified by env_port env_names and env_port_vals
are returned in newly allocated virtual memory. This memory should
be released by a call to vm_deallocate once the items are no longer
needed.

env_set_stlist sets a number of string variables environment
specified by env_port is provided for efficiency and is mainly
intended to be used to set a Mach environment to be the same as the
Unix environ area.

env_set_ptlist sets a number of port variables environment
specified by env_port is provided for efficiency.

DIAGNOSTICS
KERN_SUCCESS operation succeeded

ENV_UNKNOWN_PORT env_port does not reference a known
environment

ENV_READ_ONLY env_port only allows read access to the
environment ( for env_set_stlist and
env_set_plist).

ENV_WRONG_VAR_TYPE one of the variables was already defined
as a port variable (for env_set_stlist) or
as as string variable ( for
env_set_ptlist).

FILES
/usr/include/servers/env_mgr.h, /usr/include/servers/emdefs.h

SEE ALSO
env_string(3), env_port(3), env_conn(3)