Support functions for command line programs. More...

#include <apr_pools.h>
#include <apr_getopt.h>
#include <apr_want.h>
#include "svn_types.h"
#include "svn_auth.h"
#include "svn_config.h"

Data Structures
struct	svn_cmdline_prompt_baton2_t
	A prompt function/baton pair, and the path to the configuration directory. More...

struct	svn_cmdline_prompt_baton_t
	Like svn_cmdline_prompt_baton2_t, but without the path to the configuration directory. More...

Typedefs
typedef struct svn_cmdline_prompt_baton2_t	svn_cmdline_prompt_baton2_t
	A prompt function/baton pair, and the path to the configuration directory. More...

typedef struct svn_cmdline_prompt_baton_t	svn_cmdline_prompt_baton_t
	Like svn_cmdline_prompt_baton2_t, but without the path to the configuration directory. More...

Functions
int	svn_cmdline_init (const char progname, FILE error_stream)
	Set up the locale for character conversion, and initialize APR. More...

svn_error_t *	svn_cmdline_cstring_from_utf8 (const char *dest, const char src, apr_pool_t *pool)
	Set dest to an output-encoded C string from UTF-8 C string src; allocate dest in pool.

const char *	svn_cmdline_cstring_from_utf8_fuzzy (const char src, apr_pool_t pool)
	Like svn_utf_cstring_from_utf8_fuzzy(), but converts to an output-encoded C string. More...

svn_error_t *	svn_cmdline_cstring_to_utf8 (const char *dest, const char src, apr_pool_t *pool)
	Set dest to a UTF-8-encoded C string from input-encoded C string src; allocate dest in pool.

svn_error_t *	svn_cmdline_path_local_style_from_utf8 (const char *dest, const char src, apr_pool_t *pool)
	Set dest to an output-encoded natively-formatted path string from canonical path src; allocate dest in pool.

svn_error_t *	svn_cmdline_printf (apr_pool_t pool, const char fmt,...)
	Write to stdout, using a printf-like format string fmt, passed through apr_pvsprintf(). More...

svn_error_t *	svn_cmdline_fprintf (FILE stream, apr_pool_t pool, const char *fmt,...)
	Write to the stdio stream, using a printf-like format string fmt, passed through apr_pvsprintf(). More...

svn_error_t *	svn_cmdline_fputs (const char string, FILE stream, apr_pool_t *pool)
	Output the string to the stdio stream, converting from UTF-8 to the output encoding. More...

svn_error_t *	svn_cmdline_fflush (FILE *stream)
	Flush output buffers of the stdio stream, returning an error if that fails. More...

const char *	svn_cmdline_output_encoding (apr_pool_t *pool)
	Return the name of the output encoding allocated in pool, or `APR_LOCALE_CHARSET` if the output encoding is the same as the locale encoding. More...

int	svn_cmdline_handle_exit_error (svn_error_t error, apr_pool_t pool, const char *prefix)
	Handle error in preparation for immediate exit from a command-line client. More...

svn_error_t *	svn_cmdline_prompt_user2 (const char *result, const char prompt_str, svn_cmdline_prompt_baton_t baton, apr_pool_t pool)
	Prompt the user for input, using prompt_str for the prompt and baton (which may be `NULL`) for cancellation, and returning the user's response in result, allocated in pool. More...

svn_error_t *	svn_cmdline_prompt_user (const char *result, const char prompt_str, apr_pool_t *pool)
	Similar to svn_cmdline_prompt_user2, but without cancellation support. More...

svn_error_t *	svn_cmdline_auth_simple_prompt (svn_auth_cred_simple_t *cred_p, void baton, const char realm, const char username, svn_boolean_t may_save, apr_pool_t *pool)
	An implementation of `svn_auth_simple_prompt_func_t` that prompts the user for keyboard input on the command line. More...

svn_error_t *	svn_cmdline_auth_username_prompt (svn_auth_cred_username_t *cred_p, void baton, const char realm, svn_boolean_t may_save, apr_pool_t pool)
	An implementation of `svn_auth_username_prompt_func_t` that prompts the user for their username via the command line. More...

svn_error_t *	svn_cmdline_auth_ssl_server_trust_prompt (svn_auth_cred_ssl_server_trust_t *cred_p, void baton, const char realm, apr_uint32_t failures, const svn_auth_ssl_server_cert_info_t cert_info, svn_boolean_t may_save, apr_pool_t *pool)
	An implementation of `svn_auth_ssl_server_trust_prompt_func_t` that asks the user if they trust a specific ssl server via the command line. More...

svn_error_t *	svn_cmdline_auth_ssl_client_cert_prompt (svn_auth_cred_ssl_client_cert_t *cred_p, void baton, const char realm, svn_boolean_t may_save, apr_pool_t pool)
	An implementation of `svn_auth_ssl_client_cert_prompt_func_t` that prompts the user for the filename of their SSL client certificate via the command line. More...

svn_error_t *	svn_cmdline_auth_ssl_client_cert_pw_prompt (svn_auth_cred_ssl_client_cert_pw_t *cred_p, void baton, const char realm, svn_boolean_t may_save, apr_pool_t pool)
	An implementation of `svn_auth_ssl_client_cert_pw_prompt_func_t` that prompts the user for their SSL certificate password via the command line. More...

svn_error_t *	svn_cmdline_auth_plaintext_prompt (svn_boolean_t may_save_plaintext, const char realmstring, void baton, apr_pool_t pool)
	An implementation of `svn_auth_plaintext_prompt_func_t` that prompts the user whether storing unencrypted passwords to disk is OK. More...

svn_error_t *	svn_cmdline_auth_plaintext_passphrase_prompt (svn_boolean_t may_save_plaintext, const char realmstring, void baton, apr_pool_t pool)
	An implementation of `svn_auth_plaintext_passphrase_prompt_func_t` that prompts the user whether storing unencrypted passphrase to disk is OK. More...

svn_error_t *	svn_cmdline_create_auth_baton2 (svn_auth_baton_t *ab, svn_boolean_t non_interactive, const char username, const char password, const char config_dir, svn_boolean_t no_auth_cache, svn_boolean_t trust_server_cert_unknown_ca, svn_boolean_t trust_server_cert_cn_mismatch, svn_boolean_t trust_server_cert_expired, svn_boolean_t trust_server_cert_not_yet_valid, svn_boolean_t trust_server_cert_other_failure, svn_config_t cfg, svn_cancel_func_t cancel_func, void cancel_baton, apr_pool_t *pool)
	Set ab to an authentication baton allocated from pool* and initialized with the standard set of authentication providers used by the command line client. More...

svn_error_t *	svn_cmdline_create_auth_baton (svn_auth_baton_t *ab, svn_boolean_t non_interactive, const char username, const char password, const char config_dir, svn_boolean_t no_auth_cache, svn_boolean_t trust_server_cert, svn_config_t cfg, svn_cancel_func_t cancel_func, void cancel_baton, apr_pool_t *pool)

svn_error_t *	svn_cmdline_setup_auth_baton (svn_auth_baton_t *ab, svn_boolean_t non_interactive, const char username, const char password, const char config_dir, svn_boolean_t no_auth_cache, svn_config_t cfg, svn_cancel_func_t cancel_func, void cancel_baton, apr_pool_t *pool)
	Similar to svn_cmdline_create_auth_baton(), but with trust_server_cert always set to false. More...

Detailed Description

Support functions for command line programs.

Definition in file svn_cmdline.h.

Typedef Documentation

typedef struct svn_cmdline_prompt_baton2_t svn_cmdline_prompt_baton2_t

A prompt function/baton pair, and the path to the configuration directory.

To be passed as the baton argument to the svn_cmdline_*_prompt functions.

Since: New in 1.6.

typedef struct svn_cmdline_prompt_baton_t svn_cmdline_prompt_baton_t

Like svn_cmdline_prompt_baton2_t, but without the path to the configuration directory.

Since: New in 1.4.

Deprecated:: Provided for backward compatibility with the 1.5 API.

Function Documentation

svn_error_t* svn_cmdline_auth_plaintext_passphrase_prompt	(	svn_boolean_t *	may_save_plaintext,
		const char *	realmstring,
		void *	baton,
		apr_pool_t *	pool
	)

An implementation of svn_auth_plaintext_passphrase_prompt_func_t that prompts the user whether storing unencrypted passphrase to disk is OK.

Expects a svn_cmdline_prompt_baton2_t to be passed as baton.

Since: New in 1.6.

svn_error_t* svn_cmdline_auth_plaintext_prompt	(	svn_boolean_t *	may_save_plaintext,
		const char *	realmstring,
		void *	baton,
		apr_pool_t *	pool
	)

An implementation of svn_auth_plaintext_prompt_func_t that prompts the user whether storing unencrypted passwords to disk is OK.

Expects a svn_cmdline_prompt_baton2_t to be passed as baton.

Since: New in 1.6.

svn_error_t* svn_cmdline_auth_simple_prompt	(	svn_auth_cred_simple_t **	cred_p,
		void *	baton,
		const char *	realm,
		const char *	username,
		svn_boolean_t	may_save,
		apr_pool_t *	pool
	)

An implementation of svn_auth_simple_prompt_func_t that prompts the user for keyboard input on the command line.

Since: New in 1.4.

Expects a svn_cmdline_prompt_baton_t to be passed as baton.

svn_error_t* svn_cmdline_auth_ssl_client_cert_prompt	(	svn_auth_cred_ssl_client_cert_t **	cred_p,
		void *	baton,
		const char *	realm,
		svn_boolean_t	may_save,
		apr_pool_t *	pool
	)

An implementation of svn_auth_ssl_client_cert_prompt_func_t that prompts the user for the filename of their SSL client certificate via the command line.

Records absolute path of the SSL client certificate file.

Since: New in 1.4.

Expects a svn_cmdline_prompt_baton_t to be passed as baton.

svn_error_t* svn_cmdline_auth_ssl_client_cert_pw_prompt	(	svn_auth_cred_ssl_client_cert_pw_t **	cred_p,
		void *	baton,
		const char *	realm,
		svn_boolean_t	may_save,
		apr_pool_t *	pool
	)

An implementation of svn_auth_ssl_client_cert_pw_prompt_func_t that prompts the user for their SSL certificate password via the command line.

Since: New in 1.4.

Expects a svn_cmdline_prompt_baton_t to be passed as baton.

svn_error_t* svn_cmdline_auth_ssl_server_trust_prompt	(	svn_auth_cred_ssl_server_trust_t **	cred_p,
		void *	baton,
		const char *	realm,
		apr_uint32_t	failures,
		const svn_auth_ssl_server_cert_info_t *	cert_info,
		svn_boolean_t	may_save,
		apr_pool_t *	pool
	)

An implementation of svn_auth_ssl_server_trust_prompt_func_t that asks the user if they trust a specific ssl server via the command line.

Since: New in 1.4.

Expects a svn_cmdline_prompt_baton_t to be passed as baton.

svn_error_t* svn_cmdline_auth_username_prompt	(	svn_auth_cred_username_t **	cred_p,
		void *	baton,
		const char *	realm,
		svn_boolean_t	may_save,
		apr_pool_t *	pool
	)

An implementation of svn_auth_username_prompt_func_t that prompts the user for their username via the command line.

Since: New in 1.4.

Expects a svn_cmdline_prompt_baton_t to be passed as baton.

svn_error_t* svn_cmdline_create_auth_baton2	(	svn_auth_baton_t **	ab,
		svn_boolean_t	non_interactive,
		const char *	username,
		const char *	password,
		const char *	config_dir,
		svn_boolean_t	no_auth_cache,
		svn_boolean_t	trust_server_cert_unknown_ca,
		svn_boolean_t	trust_server_cert_cn_mismatch,
		svn_boolean_t	trust_server_cert_expired,
		svn_boolean_t	trust_server_cert_not_yet_valid,
		svn_boolean_t	trust_server_cert_other_failure,
		svn_config_t *	cfg,
		svn_cancel_func_t	cancel_func,
		void *	cancel_baton,
		apr_pool_t *	pool
	)

Set *ab to an authentication baton allocated from pool and initialized with the standard set of authentication providers used by the command line client.

non_interactive, username, password, config_dir, and no_auth_cache are the values of the command line options of the corresponding names.

If non_interactive is TRUE, then the following parameters control whether an invalid SSL certificate will be accepted regardless of a specific verification failure:

trust_server_cert_unknown_ca: If TRUE, accept certificates from unknown certificate authorities.

trust_server_cert_cn_mismatch: If TRUE, accept certificates even if the Common Name attribute of the certificate differs from the hostname of the server.

trust_server_cert_expired: If TRUE, accept certificates even if they are expired.

trust_server_cert_not_yet_valid: If TRUE, accept certificates from the future.

trust_server_cert_other_failure: If TRUE, accept certificates even if any other verification failure than the above occured.

cfg is the SVN_CONFIG_CATEGORY_CONFIG configuration, and cancel_func and cancel_baton control the cancellation of the prompting providers that are initialized.

Use pool for all allocations.

Since: New in 1.9.

const char* svn_cmdline_cstring_from_utf8_fuzzy	(	const char *	src,
		apr_pool_t *	pool
	)

Like svn_utf_cstring_from_utf8_fuzzy(), but converts to an output-encoded C string.

svn_error_t* svn_cmdline_fflush ( FILE * stream )

Flush output buffers of the stdio stream, returning an error if that fails.

This is just a wrapper for the standard fflush() function for consistent error handling.

Since: New in 1.1.

svn_error_t* svn_cmdline_fprintf	(	FILE *	stream,
		apr_pool_t *	pool,
		const char *	fmt,
			...
	)

Write to the stdio stream, using a printf-like format string fmt, passed through apr_pvsprintf().

All string arguments are in UTF-8; the output is converted to the output encoding. Use pool for temporary allocation.

Since: New in 1.1.

svn_error_t* svn_cmdline_fputs	(	const char *	string,
		FILE *	stream,
		apr_pool_t *	pool
	)

Output the string to the stdio stream, converting from UTF-8 to the output encoding.

Use pool for temporary allocation.

Since: New in 1.1.

int svn_cmdline_handle_exit_error	(	svn_error_t *	error,
		apr_pool_t *	pool,
		const char *	prefix
	)

Handle error in preparation for immediate exit from a command-line client.

Specifically:

Call svn_handle_error2(error, stderr, FALSE, prefix), clear error, destroy pool iff it is non-NULL, and return EXIT_FAILURE.

Since: New in 1.3.

int svn_cmdline_init	(	const char *	progname,
		FILE *	error_stream
	)

Set up the locale for character conversion, and initialize APR.

If error_stream is non-NULL, print error messages to the stream, using progname as the program name. Attempt to set stdout to line-buffered mode, and error_stream to unbuffered mode. Return EXIT_SUCCESS if successful, otherwise EXIT_FAILURE.

Note: This function should be called exactly once at program startup, before calling any other APR or Subversion functions.

const char* svn_cmdline_output_encoding ( apr_pool_t * pool )

Return the name of the output encoding allocated in pool, or APR_LOCALE_CHARSET if the output encoding is the same as the locale encoding.

Since: New in 1.3.

svn_error_t* svn_cmdline_printf	(	apr_pool_t *	pool,
		const char *	fmt,
			...
	)

Write to stdout, using a printf-like format string fmt, passed through apr_pvsprintf().

All string arguments are in UTF-8; the output is converted to the output encoding. Use pool for temporary allocation.

Since: New in 1.1.

svn_error_t* svn_cmdline_prompt_user	(	const char **	result,
		const char *	prompt_str,
		apr_pool_t *	pool
	)

Similar to svn_cmdline_prompt_user2, but without cancellation support.

Deprecated:: Provided for backward compatibility with the 1.4 API.

svn_error_t* svn_cmdline_prompt_user2	(	const char **	result,
		const char *	prompt_str,
		svn_cmdline_prompt_baton_t *	baton,
		apr_pool_t *	pool
	)

Prompt the user for input, using prompt_str for the prompt and baton (which may be NULL) for cancellation, and returning the user's response in result, allocated in pool.

Since: New in 1.5.

svn_error_t* svn_cmdline_setup_auth_baton	(	svn_auth_baton_t **	ab,
		svn_boolean_t	non_interactive,
		const char *	username,
		const char *	password,
		const char *	config_dir,
		svn_boolean_t	no_auth_cache,
		svn_config_t *	cfg,
		svn_cancel_func_t	cancel_func,
		void *	cancel_baton,
		apr_pool_t *	pool
	)

Similar to svn_cmdline_create_auth_baton(), but with trust_server_cert always set to false.

Since: New in 1.4.

Deprecated:: Provided for backward compatibility with the 1.5 API. Use svn_cmdline_create_auth_baton() instead.

Note: This deprecation does not follow the usual pattern of putting a new number on end of the function's name. Instead, the new function name is distinguished from the old by a grammatical improvement: the verb "create" instead of the noun "setup".

Data Structures

Typedefs

Functions

Detailed Description

Typedef Documentation

Function Documentation