cached authentication data.

Accessing cached authentication data in the user config area. More...

Defines
#define	SVN_CONFIG_REALMSTRING_KEY   "svn:realmstring"
	A hash-key pointing to a realmstring.
Functions
svn_error_t *	svn_config_read_auth_data (apr_hash_t **hash, const char *cred_kind, const char *realmstring, const char *config_dir, apr_pool_t *pool)
	Use cred_kind and realmstring to locate a file within the ~/.subversion/auth/ area.
svn_error_t *	svn_config_write_auth_data (apr_hash_t *hash, const char *cred_kind, const char *realmstring, const char *config_dir, apr_pool_t *pool)
	Use cred_kind and realmstring to create or overwrite a file within the ~/.subversion/auth/ area.

---

Detailed Description

Accessing cached authentication data in the user config area.

---

Define Documentation

#define SVN_CONFIG_REALMSTRING_KEY   "svn:realmstring"

A hash-key pointing to a realmstring.

Every file containing authentication data should have this key.

Definition at line 375 of file svn_config.h.

---

Function Documentation

svn_error_t* svn_config_read_auth_data	(	apr_hash_t **	hash,
		const char *	cred_kind,
		const char *	realmstring,
		const char *	config_dir,
		apr_pool_t *	pool
	)

Use cred_kind and realmstring to locate a file within the ~/.subversion/auth/ area.

If the file exists, initialize *hash and load the file contents into the hash, using pool. If the file doesn't exist, set *hash to NULL.

If config_dir is not NULL it specifies a directory from which to read the config overriding all other sources.

Besides containing the original credential fields, the hash will also contain SVN_CONFIG_REALMSTRING_KEY. The caller can examine this value as a sanity-check that the correct file was loaded.

The hashtable will contain const char * keys and svn_string_t * values.

svn_error_t* svn_config_write_auth_data	(	apr_hash_t *	hash,
		const char *	cred_kind,
		const char *	realmstring,
		const char *	config_dir,
		apr_pool_t *	pool
	)

Use cred_kind and realmstring to create or overwrite a file within the ~/.subversion/auth/ area.

Write the contents of hash into the file. If config_dir is not NULL it specifies a directory to read the config overriding all other sources.

Also, add realmstring to the file, with key SVN_CONFIG_REALMSTRING_KEY. This allows programs (or users) to verify exactly which set credentials live within the file.

The hashtable must contain const char * keys and svn_string_t * values.

---