Classes
struct	apr_crypto_hash_t

Typedefs
typedef struct apr_crypto_hash_t	apr_crypto_hash_t

typedef void	apr_crypto_hash_init_t(apr_crypto_hash_t *hash)

typedef void	apr_crypto_hash_add_t(apr_crypto_hash_t hash, const void data, apr_size_t bytes)

typedef void	apr_crypto_hash_finish_t(apr_crypto_hash_t hash, unsigned char result)

typedef struct apr_random_t	apr_random_t

Functions
	APR_DECLARE (apr_crypto_hash_t ) apr_crypto_sha256_new(apr_pool_t p)

	APR_DECLARE (void) apr_random_init(apr_random_t *g

	APR_DECLARE (apr_random_t ) apr_random_standard_new(apr_pool_t p)

	APR_DECLARE (apr_status_t) apr_random_insecure_bytes(apr_random_t *g

Variables
apr_pool_t *	p

apr_pool_t apr_crypto_hash_t *	pool_hash

apr_pool_t apr_crypto_hash_t apr_crypto_hash_t *	key_hash

apr_pool_t apr_crypto_hash_t apr_crypto_hash_t apr_crypto_hash_t *	prng_hash

const void *	entropy_

const void apr_size_t	bytes

void *	random

Detailed Description

Typedef Documentation

◆ apr_crypto_hash_add_t

typedef void apr_crypto_hash_add_t(apr_crypto_hash_t *hash, const void *data, apr_size_t bytes)

Definition at line 41 of file apr_random.h.

◆ apr_crypto_hash_finish_t

typedef void apr_crypto_hash_finish_t(apr_crypto_hash_t *hash, unsigned char *result)

Definition at line 43 of file apr_random.h.

◆ apr_crypto_hash_init_t

typedef void apr_crypto_hash_init_t(apr_crypto_hash_t *hash)

Definition at line 40 of file apr_random.h.

◆ apr_crypto_hash_t

typedef struct apr_crypto_hash_t apr_crypto_hash_t

Definition at line 38 of file apr_random.h.

◆ apr_random_t

typedef struct apr_random_t apr_random_t

Opaque PRNG structure.

Definition at line 63 of file apr_random.h.

Function Documentation

◆ APR_DECLARE() [1/4]

APR_DECLARE ( apr_crypto_hash_t * )

Allocate and initialize the SHA-256 context

Parameters

p	The pool to allocate from

Definition at line 38 of file sha2_glue.c.

◆ APR_DECLARE() [2/4]

APR_DECLARE ( apr_random_t * )

Allocate and initialize (apr_crypto_sha256_new) a new PRNG state.

Parameters

p	The pool to allocate from

Definition at line 188 of file apr_random.c.

◆ APR_DECLARE() [3/4]

APR_DECLARE ( apr_status_t )

Generate cryptographically insecure random bytes.

Parameters

g	The RNG state
random	Buffer to fill with random bytes
bytes	Length of buffer in bytes

Generate cryptographically secure random bytes.

Parameters

g	The RNG state
random	Buffer to fill with random bytes
bytes	Length of buffer in bytes

Return APR_SUCCESS if the cryptographic PRNG has been seeded with enough data, APR_ENOTENOUGHENTROPY otherwise.

Parameters

r	The RNG state

Return APR_SUCCESS if the PRNG has been seeded with enough data, APR_ENOTENOUGHENTROPY otherwise.

Parameters

r	The PRNG state

< File is read-only

< File is executable

< all protections

< File is read-only

< Write by user

<

Deprecated:

See also: APR_FPROT_UWRITE

< Write by group

<

Deprecated:

See also: APR_FPROT_GWRITE

< Write by others

<

Deprecated:

See also: APR_FPROT_WWRITE

< Write by user

<

Deprecated:

See also: APR_FPROT_UWRITE

< Write by group

<

Deprecated:

See also: APR_FPROT_GWRITE

< Write by others

<

Deprecated:

See also: APR_FPROT_WWRITE

< File is executable

< Execute by user

<

Deprecated:

See also: APR_FPROT_UEXECUTE

< Execute by group

<

Deprecated:

See also: APR_FPROT_GEXECUTE

< Execute by others

<

Deprecated:

See also: APR_FPROT_WEXECUTE

< Execute by user

<

Deprecated:

See also: APR_FPROT_UEXECUTE

< Execute by group

<

Deprecated:

See also: APR_FPROT_GEXECUTE

< Execute by others

<

Deprecated:

See also: APR_FPROT_WEXECUTE

< Stat the link not the file itself if it is a link

< ->name in proper case

< Access Time

< Create the file if not there

< Open the file for reading

< Open the file for writing

< Delete the file after close

< Open should fail if APR_FOPEN_CREATE and file exists.

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Read by user

<

Deprecated:

See also: APR_FPROT_UREAD

< Write by user

<

Deprecated:

See also: APR_FPROT_UWRITE

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< ->name in proper case

< Modification Time

< Access Time

< Creation or inode-changed time

< Type

< Size of the file

< Storage size consumed by the file

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< ->name in proper case

< Type

< all protections

< ->name in proper case

< File is read-only

< File is hidden

< File is read-only

< File is hidden

< Platform dependent flag to enable * non blocking file io

< Open the file for reading

< Open the file for writing

< Open the file for reading

< Open the file for writing

< Open the file for buffered I/O

< Create the file if not there

< Open should fail if APR_FOPEN_CREATE and file exists.

< Open the file and truncate to 0 length

< Open should fail if APR_FOPEN_CREATE and file exists.

< Create the file if not there

< Open the file and truncate to 0 length

< Append to the end of the file

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Delete the file after close

< Open the file for buffered I/O

< Open the file for writing

< Open the file for reading

< Append to the end of the file

< an atomic unix apr_stat()

< Open the file for writing

< Create the file if not there

< Open the file and truncate to 0 length

< Open the file for writing

< Create the file if not there

< Append to the end of the file

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< File is read-only

< File is executable

< all protections

< File is read-only

< Write by user

<

Deprecated:

See also: APR_FPROT_UWRITE

< Write by group

<

Deprecated:

See also: APR_FPROT_GWRITE

< Write by others

<

Deprecated:

See also: APR_FPROT_WWRITE

< Write by user

<

Deprecated:

See also: APR_FPROT_UWRITE

< Write by group

<

Deprecated:

See also: APR_FPROT_GWRITE

< Write by others

<

Deprecated:

See also: APR_FPROT_WWRITE

< File is executable

< Execute by user

<

Deprecated:

See also: APR_FPROT_UEXECUTE

< Execute by group

<

Deprecated:

See also: APR_FPROT_GEXECUTE

< Execute by others

<

Deprecated:

See also: APR_FPROT_WEXECUTE

< Execute by user

<

Deprecated:

See also: APR_FPROT_UEXECUTE

< Execute by group

<

Deprecated:

See also: APR_FPROT_GEXECUTE

< Execute by others

<

Deprecated:

See also: APR_FPROT_WEXECUTE

< Access Time

< Stat the link not the file itself if it is a link

< Create the file if not there

< Open the file for reading

< Open the file for writing

< Open should fail if APR_FOPEN_CREATE and file exists.

< Delete the file after close

< Open the file for reading

< Open the file for writing

< Open the file for reading

< Open the file for writing

< Create the file if not there

< Open should fail if APR_FOPEN_CREATE and file exists.

< Create the file if not there

< Append to the end of the file

< Open the file and truncate to 0 length

< Platform dependent flag to enable * non blocking file io

< use OS's default permissions

<

Deprecated:

See also: APR_FPROT_OS_DEFAULT

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Open the file for buffered I/O

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Open the file for buffered I/O

< Open the file for writing

< Open the file for reading

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

The problem with trying to output the entire iovec is that we cannot maintain the behaviour that a real writev would have. If we iterate over the iovec one at a time, we lose the atomic properties of writev(). The other option is to combine the entire iovec into one buffer that we could then send in one call to write(). This is not reasonable since we do not know how much data an iovec could contain.

The only reasonable option, that maintains the semantics of a real writev(), is to only write the first iovec. Callers of file_writev() must deal with partial writes as they normally would. If you want to ensure an entire iovec is written, use apr_file_writev_full().

< ->name in proper case

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Size of the file

< dev and inode

< Number of links

< ->name in proper case

< Type

< ->name in proper case

< File is read-only

< File is hidden

< File is read-only

< File is hidden

< Open the file for reading

< use OS's default permissions

<

Deprecated:

See also: APR_FPROT_OS_DEFAULT

< Platform dependent flag to enable * non blocking file io

< Open the file for reading

< Open the file for writing

< Create the file if not there

< Open should fail if APR_FOPEN_CREATE and file exists.

< Open the file and truncate to 0 length

< Open should fail if APR_FOPEN_CREATE and file exists.

< Create the file if not there

< Delete the file after close

< Open the file for reading

< Open the file for writing

< Platform dependent tag to open the file for use across multiple threads

< Append to the end of the file

< Open the file for buffered I/O

< Platform dependent flag to enable * sparse file support, see WARNING below

< Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

< Append to the end of the file

< Open the file for buffered I/O

< Open the file for writing

< Open the file for reading

< Platform dependent tag to open the file for use across multiple threads

< Exclusive lock. Only one process may hold an exclusive lock at any given time. This is analogous to a "write lock".

< Platform dependent tag to open the file for use across multiple threads

< Size of the file

< Platform dependent tag to open the file for use across multiple threads

< Size of the file

Definition at line 74 of file apr_atomic.c.

◆ APR_DECLARE() [4/4]

APR_DECLARE ( void )

Initialize a PRNG state

Parameters

g	The PRNG state
p	The pool to allocate from
pool_hash	Pool hash functions
key_hash	Key hash functions
prng_hash	PRNG hash functions

Mix the randomness pools.

Parameters

g	The PRNG state
entropy_	Entropy buffer
bytes	Length of entropy_ in bytes

Ensures that E bits of conditional entropy are mixed into the PRNG before any further randomness is extracted.

Parameters

g	The RNG state

Mix the randomness pools after forking.

Parameters

proc	The resulting process handle from apr_proc_fork()

Remarks: Call this in the child after forking to mix the randomness pools. Note that its generally a bad idea to fork a process with a real PRNG in it - better to have the PRNG externally and get the randomness from there. However, if you really must do it, then you should supply all your entropy to all the PRNGs - don't worry, they won't produce the same output.; Note that apr_proc_fork() calls this for you, so only weird applications need ever call it themselves.

< File is read-only

< File is executable

< all protections

< File is read-only

< Write by user

<