System information routines
[Portability layer]

Functions
apr_status_t	port_executable_name (char **self_name)
	Determines the absolute path of the executing process.
int	port_CPUs_number (void)
	Returns the number of processors in the system.
const char *	port_CPU_architecture (void)
	Returns the name of CPU architecture.
apr_status_t	port_OS_name_version (char **os_name, char **os_ver, apr_pool_t *pool)
	Provides the name and version of the host operating system.
apr_status_t	port_user_name (char **account, apr_pool_t *pool)
	Returns the name of the account under which the current process is executed.
apr_status_t	port_user_home (char **path, apr_pool_t *pool)
	Returns the home path of the account under which the process is executed.
apr_status_t	port_user_timezone (char **tzname, apr_pool_t *pool)
	Returns the name of current system time zone.

---

Function Documentation

apr_status_t port_executable_name

(

char **

self_name

)

Determines the absolute path of the executing process.

Parameters:

[out]

self_name

- the pointer to the requested path string

Returns:

APR_SUCCESS if OK; otherwise, an error code.

Note:

The value returned can be freed by STD_FREE macro.

int port_CPUs_number

(

void

)

Returns the number of processors in the system.

const char* port_CPU_architecture

(

void

)

Returns the name of CPU architecture.

apr_status_t port_OS_name_version	(	char **	os_name,
		char **	os_ver,
		apr_pool_t *	pool
	)

Provides the name and version of the host operating system.

Parameters:

[out]	os_name	- the pointer to the OS name string
[out]	os_ver	- the pointer to the OS version string
	pool	- a pool to allocate return buffers

Returns:

APR_SUCCESS if OK; otherwise, an error code.

apr_status_t port_user_name	(	char **	account,
		apr_pool_t *	pool
	)

Returns the name of the account under which the current process is executed.

Parameters:

[out]	account	- the pointer to the requested name string
	pool	- a pool to allocate the return buffer

Returns:

APR_SUCCESS if OK; otherwise, an error code.

apr_status_t port_user_home	(	char **	path,
		apr_pool_t *	pool
	)

Returns the home path of the account under which the process is executed.

Parameters:

[out]	path	- the pointer to the requested path string
	pool	- a pool to allocate return buffer

Returns:

APR_SUCCESS if OK; otherwise, an error code.

apr_status_t port_user_timezone	(	char **	tzname,
		apr_pool_t *	pool
	)

Returns the name of current system time zone.

Time zone names are defined in the tz database, see ftp://elsie.nci.nih.gov/pub/.

Parameters:

[out]	tzname	- the pointer to the name string
	pool	- a pool to allocate return buffer

Returns:

APR_SUCCESS if OK; otherwise, an error code.

---