subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bre...@apache.org
Subject svn commit: r1493010 [8/16] - in /subversion/site/publish/docs: api/1.8/ api/1.8/search/ javahl/1.8/ javahl/1.8/org/apache/subversion/javahl/ javahl/1.8/org/apache/subversion/javahl/callback/ javahl/1.8/org/apache/subversion/javahl/types/ javahl/1.8/or...
Date Fri, 14 Jun 2013 09:39:36 GMT
Modified: subversion/site/publish/docs/api/1.8/svn__auth_8h_source.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/api/1.8/svn__auth_8h_source.html?rev=1493010&r1=1493009&r2=1493010&view=diff
==============================================================================
--- subversion/site/publish/docs/api/1.8/svn__auth_8h_source.html (original)
+++ subversion/site/publish/docs/api/1.8/svn__auth_8h_source.html Fri Jun 14 09:39:23 2013
@@ -652,12 +652,12 @@ var searchBox = new SearchBox("searchBox
 <a name="l00569"></a>00569 <span class="preprocessor"></span><span class="comment"></span>
 <a name="l00570"></a>00570 <span class="comment">/**</span>
 <a name="l00571"></a>00571 <span class="comment"> * @name Default credentials defines</span>
-<a name="l00572"></a>00572 <span class="comment"> * Any &#39;default&#39; credentials that came in through the application itself,</span>
-<a name="l00573"></a>00573 <span class="comment"> * (e.g. --username and --password options). Property values are</span>
-<a name="l00574"></a>00574 <span class="comment"> * const char *.</span>
-<a name="l00575"></a>00575 <span class="comment"> * @{ */</span>
-<a name="l00576"></a>00576 <span class="preprocessor">#define SVN_AUTH_PARAM_DEFAULT_USERNAME  SVN_AUTH_PARAM_PREFIX &quot;username&quot;</span>
-<a name="l00577"></a>00577 <span class="preprocessor"></span><span class="preprocessor">#define SVN_AUTH_PARAM_DEFAULT_PASSWORD  SVN_AUTH_PARAM_PREFIX &quot;password&quot;</span>
+<a name="l00572"></a>00572 <span class="comment"> * Property values are const char *.</span>
+<a name="l00573"></a>00573 <span class="comment"> * @{ */</span><span class="comment"></span>
+<a name="l00574"></a>00574 <span class="comment">/** Default username provided by the application itself (e.g. --username) */</span>
+<a name="l00575"></a><a class="code" href="group__auth__fns.html#ga1479a16508589f534d1216471da6bde6">00575</a> <span class="preprocessor">#define SVN_AUTH_PARAM_DEFAULT_USERNAME  SVN_AUTH_PARAM_PREFIX &quot;username&quot;</span>
+<a name="l00576"></a>00576 <span class="preprocessor"></span><span class="comment">/** Default password provided by the application itself (e.g. --password) */</span>
+<a name="l00577"></a><a class="code" href="group__auth__fns.html#gafbff53d2e2a6ce8044a1885ada2b3175">00577</a> <span class="preprocessor">#define SVN_AUTH_PARAM_DEFAULT_PASSWORD  SVN_AUTH_PARAM_PREFIX &quot;password&quot;</span>
 <a name="l00578"></a>00578 <span class="preprocessor"></span><span class="comment">/** @} */</span>
 <a name="l00579"></a>00579 <span class="comment"></span>
 <a name="l00580"></a>00580 <span class="comment">/** @brief The application doesn&#39;t want any providers to prompt</span>
@@ -711,652 +711,658 @@ var searchBox = new SearchBox("searchBox
 <a name="l00628"></a><a class="code" href="group__auth__fns.html#ga95fc50b793dbb019a9026f783ddcf05b">00628</a> <span class="preprocessor">#define SVN_AUTH_PARAM_SSL_SERVER_CERT_INFO SVN_AUTH_PARAM_PREFIX \</span>
 <a name="l00629"></a>00629 <span class="preprocessor">  &quot;ssl:cert-info&quot;</span>
 <a name="l00630"></a>00630 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00631"></a>00631 <span class="comment">/** Some providers need access to the @c svn_config_t configuration. */</span>
-<a name="l00632"></a><a class="code" href="group__auth__fns.html#ga5c7aa71afbdc25720cade178c570a7ae">00632</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_CATEGORY_CONFIG SVN_AUTH_PARAM_PREFIX &quot;config-category-config&quot;</span>
-<a name="l00633"></a>00633 <span class="preprocessor"></span><span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_CATEGORY_SERVERS SVN_AUTH_PARAM_PREFIX &quot;config-category-servers&quot;</span>
-<a name="l00634"></a>00634 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00635"></a>00635 <span class="comment">/** @deprecated Provided for backward compatibility with the 1.5 API. */</span>
-<a name="l00636"></a><a class="code" href="group__auth__fns.html#ga1c41c986707991899ab975ec63538491">00636</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG SVN_AUTH_PARAM_CONFIG_CATEGORY_SERVERS</span>
-<a name="l00637"></a>00637 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00638"></a>00638 <span class="comment">/** The current server group. */</span>
-<a name="l00639"></a><a class="code" href="group__auth__fns.html#ga1c4d18b6b88ea56cb450be5e0c8745a1">00639</a> <span class="preprocessor">#define SVN_AUTH_PARAM_SERVER_GROUP SVN_AUTH_PARAM_PREFIX &quot;server-group&quot;</span>
+<a name="l00631"></a>00631 <span class="comment">/** This provides a pointer to a @c svn_config_t containting the config</span>
+<a name="l00632"></a>00632 <span class="comment"> * category. */</span>
+<a name="l00633"></a><a class="code" href="group__auth__fns.html#ga5c7aa71afbdc25720cade178c570a7ae">00633</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_CATEGORY_CONFIG SVN_AUTH_PARAM_PREFIX \</span>
+<a name="l00634"></a>00634 <span class="preprocessor">  &quot;config-category-config&quot;</span>
+<a name="l00635"></a>00635 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00636"></a>00636 <span class="comment">/** This provides a pointer to a @c svn_config_t containting the servers</span>
+<a name="l00637"></a>00637 <span class="comment"> * category. */</span>
+<a name="l00638"></a><a class="code" href="group__auth__fns.html#gacfdeafda34ab933e5b423d307213e5b5">00638</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_CATEGORY_SERVERS SVN_AUTH_PARAM_PREFIX \</span>
+<a name="l00639"></a>00639 <span class="preprocessor">  &quot;config-category-servers&quot;</span>
 <a name="l00640"></a>00640 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00641"></a>00641 <span class="comment">/** @brief A configuration directory that overrides the default</span>
-<a name="l00642"></a>00642 <span class="comment"> * ~/.subversion. */</span>
-<a name="l00643"></a><a class="code" href="group__auth__fns.html#ga58e759823cfe5c9d5fb7d6fc1e20446e">00643</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_DIR SVN_AUTH_PARAM_PREFIX &quot;config-dir&quot;</span>
-<a name="l00644"></a>00644 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00645"></a>00645 <span class="comment">/** Get an initial set of credentials.</span>
-<a name="l00646"></a>00646 <span class="comment"> *</span>
-<a name="l00647"></a>00647 <span class="comment"> * Ask @a auth_baton to set @a *credentials to a set of credentials</span>
-<a name="l00648"></a>00648 <span class="comment"> * defined by @a cred_kind and valid within @a realmstring, or NULL if</span>
-<a name="l00649"></a>00649 <span class="comment"> * no credentials are available.  Otherwise, return an iteration state</span>
-<a name="l00650"></a>00650 <span class="comment"> * in @a *state, so that the caller can call</span>
-<a name="l00651"></a>00651 <span class="comment"> * svn_auth_next_credentials(), in case the first set of credentials</span>
-<a name="l00652"></a>00652 <span class="comment"> * fails to authenticate.</span>
-<a name="l00653"></a>00653 <span class="comment"> *</span>
-<a name="l00654"></a>00654 <span class="comment"> * Use @a pool to allocate @a *state, and for temporary allocation.</span>
-<a name="l00655"></a>00655 <span class="comment"> * Note that @a *credentials will be allocated in @a auth_baton&#39;s pool.</span>
-<a name="l00656"></a>00656 <span class="comment"> */</span>
-<a name="l00657"></a>00657 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00658"></a>00658 <a class="code" href="group__auth__fns.html#gae830b04d8a93c8b60f802d6809425665" title="Get an initial set of credentials.">svn_auth_first_credentials</a>(<span class="keywordtype">void</span> **credentials,
-<a name="l00659"></a>00659                            <a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> **state,
-<a name="l00660"></a>00660                            <span class="keyword">const</span> <span class="keywordtype">char</span> *cred_kind,
-<a name="l00661"></a>00661                            <span class="keyword">const</span> <span class="keywordtype">char</span> *realmstring,
-<a name="l00662"></a>00662                            <a class="code" href="group__auth__fns.html#gaa77a422f326606f52366fb2fb0a43f8d" title="The type of a Subversion authentication object.">svn_auth_baton_t</a> *auth_baton,
-<a name="l00663"></a>00663                            apr_pool_t *pool);
-<a name="l00664"></a>00664 <span class="comment"></span>
-<a name="l00665"></a>00665 <span class="comment">/** Get another set of credentials, assuming previous ones failed to</span>
-<a name="l00666"></a>00666 <span class="comment"> * authenticate.</span>
-<a name="l00667"></a>00667 <span class="comment"> *</span>
-<a name="l00668"></a>00668 <span class="comment"> * Use @a state to fetch a different set of @a *credentials, as a</span>
-<a name="l00669"></a>00669 <span class="comment"> * follow-up to svn_auth_first_credentials() or</span>
-<a name="l00670"></a>00670 <span class="comment"> * svn_auth_next_credentials().  If no more credentials are available,</span>
-<a name="l00671"></a>00671 <span class="comment"> * set @a *credentials to NULL.</span>
-<a name="l00672"></a>00672 <span class="comment"> *</span>
-<a name="l00673"></a>00673 <span class="comment"> * Note that @a *credentials will be allocated in @c auth_baton&#39;s pool.</span>
-<a name="l00674"></a>00674 <span class="comment"> */</span>
-<a name="l00675"></a>00675 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00676"></a>00676 <a class="code" href="group__auth__fns.html#gab18c2431ea55881ef52b647815600cd3" title="Get another set of credentials, assuming previous ones failed to authenticate.">svn_auth_next_credentials</a>(<span class="keywordtype">void</span> **credentials,
-<a name="l00677"></a>00677                           <a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> *state,
-<a name="l00678"></a>00678                           apr_pool_t *pool);
-<a name="l00679"></a>00679 <span class="comment"></span>
-<a name="l00680"></a>00680 <span class="comment">/** Save a set of credentials.</span>
-<a name="l00681"></a>00681 <span class="comment"> *</span>
-<a name="l00682"></a>00682 <span class="comment"> * Ask @a state to store the most recently returned credentials,</span>
-<a name="l00683"></a>00683 <span class="comment"> * presumably because they successfully authenticated.</span>
-<a name="l00684"></a>00684 <span class="comment"> * All allocations should be done in @a pool.</span>
-<a name="l00685"></a>00685 <span class="comment"> *</span>
-<a name="l00686"></a>00686 <span class="comment"> * If no credentials were ever returned, do nothing.</span>
-<a name="l00687"></a>00687 <span class="comment"> */</span>
-<a name="l00688"></a>00688 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00689"></a>00689 <a class="code" href="group__auth__fns.html#gae4a43aa4ab0d4a9baf603bf7f96ec919" title="Save a set of credentials.">svn_auth_save_credentials</a>(<a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> *state,
-<a name="l00690"></a>00690                           apr_pool_t *pool);
-<a name="l00691"></a>00691 <span class="comment"></span>
-<a name="l00692"></a>00692 <span class="comment">/** Forget a set (or all) memory-cached credentials.</span>
-<a name="l00693"></a>00693 <span class="comment"> *</span>
-<a name="l00694"></a>00694 <span class="comment"> * Remove references (if any) in @a auth_baton to credentials cached</span>
-<a name="l00695"></a>00695 <span class="comment"> * therein.  If @a cred_kind and @a realmstring are non-NULL, forget</span>
-<a name="l00696"></a>00696 <span class="comment"> * only the credentials associated with those credential types and</span>
-<a name="l00697"></a>00697 <span class="comment"> * realm.  Otherwise @a cred_kind and @a realmstring must both be</span>
-<a name="l00698"></a>00698 <span class="comment"> * NULL, and this function will forget all credentials cached within</span>
-<a name="l00699"></a>00699 <span class="comment"> * @a auth_baton.</span>
-<a name="l00700"></a>00700 <span class="comment"> *</span>
-<a name="l00701"></a>00701 <span class="comment"> * @note This function does not affect persisted authentication</span>
-<a name="l00702"></a>00702 <span class="comment"> * credential storage at all.  It is merely a way to cause Subversion</span>
-<a name="l00703"></a>00703 <span class="comment"> * to forget about credentials already fetched from a provider,</span>
-<a name="l00704"></a>00704 <span class="comment"> * forcing them to be fetched again later should they be required.</span>
-<a name="l00705"></a>00705 <span class="comment"> *</span>
-<a name="l00706"></a>00706 <span class="comment"> * @since New in 1.8.</span>
-<a name="l00707"></a>00707 <span class="comment"> */</span>
-<a name="l00708"></a>00708 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00709"></a>00709 <a class="code" href="group__auth__fns.html#gaa1581f354af47a824044480e11129a22" title="Forget a set (or all) memory-cached credentials.">svn_auth_forget_credentials</a>(<a class="code" href="group__auth__fns.html#gaa77a422f326606f52366fb2fb0a43f8d" title="The type of a Subversion authentication object.">svn_auth_baton_t</a> *auth_baton,
-<a name="l00710"></a>00710                             <span class="keyword">const</span> <span class="keywordtype">char</span> *cred_kind,
-<a name="l00711"></a>00711                             <span class="keyword">const</span> <span class="keywordtype">char</span> *realmstring,
-<a name="l00712"></a>00712                             apr_pool_t *pool);
-<a name="l00713"></a>00713 <span class="comment"></span>
-<a name="l00714"></a>00714 <span class="comment">/** @} */</span>
-<a name="l00715"></a>00715 <span class="comment"></span>
-<a name="l00716"></a>00716 <span class="comment">/** Set @a *provider to an authentication provider of type</span>
-<a name="l00717"></a>00717 <span class="comment"> * svn_auth_cred_simple_t that gets information by prompting the user</span>
-<a name="l00718"></a>00718 <span class="comment"> * with @a prompt_func and @a prompt_baton.  Allocate @a *provider in</span>
-<a name="l00719"></a>00719 <span class="comment"> * @a pool.</span>
-<a name="l00720"></a>00720 <span class="comment"> *</span>
-<a name="l00721"></a>00721 <span class="comment"> * If both @c SVN_AUTH_PARAM_DEFAULT_USERNAME and</span>
-<a name="l00722"></a>00722 <span class="comment"> * @c SVN_AUTH_PARAM_DEFAULT_PASSWORD are defined as runtime</span>
-<a name="l00723"></a>00723 <span class="comment"> * parameters in the @c auth_baton, then @a *provider will return the</span>
-<a name="l00724"></a>00724 <span class="comment"> * default arguments when svn_auth_first_credentials() is called.  If</span>
-<a name="l00725"></a>00725 <span class="comment"> * svn_auth_first_credentials() fails, then @a *provider will</span>
-<a name="l00726"></a>00726 <span class="comment"> * re-prompt @a retry_limit times (via svn_auth_next_credentials()).</span>
-<a name="l00727"></a>00727 <span class="comment"> * For infinite retries, set @a retry_limit to value less than 0.</span>
-<a name="l00728"></a>00728 <span class="comment"> *</span>
-<a name="l00729"></a>00729 <span class="comment"> * @since New in 1.4.</span>
-<a name="l00730"></a>00730 <span class="comment"> */</span>
-<a name="l00731"></a>00731 <span class="keywordtype">void</span>
-<a name="l00732"></a>00732 <a class="code" href="svn__auth_8h.html#a0d1cf74b8f9e2f55a92f1be7a942adb3" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets information by p...">svn_auth_get_simple_prompt_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00733"></a>00733                                     <a class="code" href="group__auth__fns.html#gab3e889e27559677e7e1a13a9142a381d" title="Credential-constructing prompt functions.">svn_auth_simple_prompt_func_t</a> prompt_func,
-<a name="l00734"></a>00734                                     <span class="keywordtype">void</span> *prompt_baton,
-<a name="l00735"></a>00735                                     <span class="keywordtype">int</span> retry_limit,
-<a name="l00736"></a>00736                                     apr_pool_t *pool);
-<a name="l00737"></a>00737 
-<a name="l00738"></a>00738 <span class="comment"></span>
-<a name="l00739"></a>00739 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
-<a name="l00740"></a>00740 <span class="comment"> * svn_auth_cred_username_t that gets information by prompting the</span>
-<a name="l00741"></a>00741 <span class="comment"> * user with @a prompt_func and @a prompt_baton.  Allocate @a *provider</span>
-<a name="l00742"></a>00742 <span class="comment"> * in @a pool.</span>
-<a name="l00743"></a>00743 <span class="comment"> *</span>
-<a name="l00744"></a>00744 <span class="comment"> * If @c SVN_AUTH_PARAM_DEFAULT_USERNAME is defined as a runtime</span>
-<a name="l00745"></a>00745 <span class="comment"> * parameter in the @c auth_baton, then @a *provider will return the</span>
-<a name="l00746"></a>00746 <span class="comment"> * default argument when svn_auth_first_credentials() is called.  If</span>
-<a name="l00747"></a>00747 <span class="comment"> * svn_auth_first_credentials() fails, then @a *provider will</span>
-<a name="l00748"></a>00748 <span class="comment"> * re-prompt @a retry_limit times (via svn_auth_next_credentials()).</span>
-<a name="l00749"></a>00749 <span class="comment"> * For infinite retries, set @a retry_limit to value less than 0.</span>
-<a name="l00750"></a>00750 <span class="comment"> *</span>
-<a name="l00751"></a>00751 <span class="comment"> * @since New in 1.4.</span>
-<a name="l00752"></a>00752 <span class="comment"> */</span>
-<a name="l00753"></a>00753 <span class="keywordtype">void</span>
-<a name="l00754"></a>00754 <a class="code" href="svn__auth_8h.html#a99da7f5d7e4b64aadaed2b94d958aebb" title="Set *provider to an authentication provider of type svn_auth_cred_username_t that gets information by...">svn_auth_get_username_prompt_provider</a>(
-<a name="l00755"></a>00755   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00756"></a>00756   <a class="code" href="group__auth__fns.html#gaf05167cb101739421c2e9542e27d5a88" title="Set *cred by prompting the user, allocating *cred in pool.">svn_auth_username_prompt_func_t</a> prompt_func,
-<a name="l00757"></a>00757   <span class="keywordtype">void</span> *prompt_baton,
-<a name="l00758"></a>00758   <span class="keywordtype">int</span> retry_limit,
-<a name="l00759"></a>00759   apr_pool_t *pool);
-<a name="l00760"></a>00760 
-<a name="l00761"></a>00761 <span class="comment"></span>
-<a name="l00762"></a>00762 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
-<a name="l00763"></a>00763 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l00764"></a>00764 <span class="comment"> * ~/.subversion configuration directory.</span>
-<a name="l00765"></a>00765 <span class="comment"> *</span>
-<a name="l00766"></a>00766 <span class="comment"> * If the provider is going to save the password unencrypted, it calls @a</span>
-<a name="l00767"></a>00767 <span class="comment"> * plaintext_prompt_func, passing @a prompt_baton, before saving the</span>
-<a name="l00768"></a>00768 <span class="comment"> * password.</span>
-<a name="l00769"></a>00769 <span class="comment"> *</span>
-<a name="l00770"></a>00770 <span class="comment"> * If @a plaintext_prompt_func is NULL it is not called and the answer is</span>
-<a name="l00771"></a>00771 <span class="comment"> * assumed to be TRUE. This matches the deprecated behaviour of storing</span>
-<a name="l00772"></a>00772 <span class="comment"> * unencrypted passwords by default, and is only done this way for backward</span>
-<a name="l00773"></a>00773 <span class="comment"> * compatibility reasons.</span>
-<a name="l00774"></a>00774 <span class="comment"> * Client developers are highly encouraged to provide this callback</span>
-<a name="l00775"></a>00775 <span class="comment"> * to ensure their users are made aware of the fact that their password</span>
-<a name="l00776"></a>00776 <span class="comment"> * is going to be stored unencrypted. In the future, providers may</span>
-<a name="l00777"></a>00777 <span class="comment"> * default to not storing the password unencrypted if this callback is NULL.</span>
-<a name="l00778"></a>00778 <span class="comment"> *</span>
-<a name="l00779"></a>00779 <span class="comment"> * Clients can however set the callback to NULL and set</span>
-<a name="l00780"></a>00780 <span class="comment"> * SVN_AUTH_PARAM_STORE_PLAINTEXT_PASSWORDS to SVN_CONFIG_FALSE or</span>
-<a name="l00781"></a>00781 <span class="comment"> * SVN_CONFIG_TRUE to enforce a certain behaviour.</span>
-<a name="l00782"></a>00782 <span class="comment"> *</span>
-<a name="l00783"></a>00783 <span class="comment"> * Allocate @a *provider in @a pool.</span>
+<a name="l00641"></a>00641 <span class="comment">/** @deprecated Provided for backward compatibility with the 1.5 API. */</span>
+<a name="l00642"></a><a class="code" href="group__auth__fns.html#ga1c41c986707991899ab975ec63538491">00642</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG SVN_AUTH_PARAM_CONFIG_CATEGORY_SERVERS</span>
+<a name="l00643"></a>00643 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00644"></a>00644 <span class="comment">/** The current server group. */</span>
+<a name="l00645"></a><a class="code" href="group__auth__fns.html#ga1c4d18b6b88ea56cb450be5e0c8745a1">00645</a> <span class="preprocessor">#define SVN_AUTH_PARAM_SERVER_GROUP SVN_AUTH_PARAM_PREFIX &quot;server-group&quot;</span>
+<a name="l00646"></a>00646 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00647"></a>00647 <span class="comment">/** @brief A configuration directory that overrides the default</span>
+<a name="l00648"></a>00648 <span class="comment"> * ~/.subversion. */</span>
+<a name="l00649"></a><a class="code" href="group__auth__fns.html#ga58e759823cfe5c9d5fb7d6fc1e20446e">00649</a> <span class="preprocessor">#define SVN_AUTH_PARAM_CONFIG_DIR SVN_AUTH_PARAM_PREFIX &quot;config-dir&quot;</span>
+<a name="l00650"></a>00650 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00651"></a>00651 <span class="comment">/** Get an initial set of credentials.</span>
+<a name="l00652"></a>00652 <span class="comment"> *</span>
+<a name="l00653"></a>00653 <span class="comment"> * Ask @a auth_baton to set @a *credentials to a set of credentials</span>
+<a name="l00654"></a>00654 <span class="comment"> * defined by @a cred_kind and valid within @a realmstring, or NULL if</span>
+<a name="l00655"></a>00655 <span class="comment"> * no credentials are available.  Otherwise, return an iteration state</span>
+<a name="l00656"></a>00656 <span class="comment"> * in @a *state, so that the caller can call</span>
+<a name="l00657"></a>00657 <span class="comment"> * svn_auth_next_credentials(), in case the first set of credentials</span>
+<a name="l00658"></a>00658 <span class="comment"> * fails to authenticate.</span>
+<a name="l00659"></a>00659 <span class="comment"> *</span>
+<a name="l00660"></a>00660 <span class="comment"> * Use @a pool to allocate @a *state, and for temporary allocation.</span>
+<a name="l00661"></a>00661 <span class="comment"> * Note that @a *credentials will be allocated in @a auth_baton&#39;s pool.</span>
+<a name="l00662"></a>00662 <span class="comment"> */</span>
+<a name="l00663"></a>00663 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00664"></a>00664 <a class="code" href="group__auth__fns.html#gae830b04d8a93c8b60f802d6809425665" title="Get an initial set of credentials.">svn_auth_first_credentials</a>(<span class="keywordtype">void</span> **credentials,
+<a name="l00665"></a>00665                            <a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> **state,
+<a name="l00666"></a>00666                            <span class="keyword">const</span> <span class="keywordtype">char</span> *cred_kind,
+<a name="l00667"></a>00667                            <span class="keyword">const</span> <span class="keywordtype">char</span> *realmstring,
+<a name="l00668"></a>00668                            <a class="code" href="group__auth__fns.html#gaa77a422f326606f52366fb2fb0a43f8d" title="The type of a Subversion authentication object.">svn_auth_baton_t</a> *auth_baton,
+<a name="l00669"></a>00669                            apr_pool_t *pool);
+<a name="l00670"></a>00670 <span class="comment"></span>
+<a name="l00671"></a>00671 <span class="comment">/** Get another set of credentials, assuming previous ones failed to</span>
+<a name="l00672"></a>00672 <span class="comment"> * authenticate.</span>
+<a name="l00673"></a>00673 <span class="comment"> *</span>
+<a name="l00674"></a>00674 <span class="comment"> * Use @a state to fetch a different set of @a *credentials, as a</span>
+<a name="l00675"></a>00675 <span class="comment"> * follow-up to svn_auth_first_credentials() or</span>
+<a name="l00676"></a>00676 <span class="comment"> * svn_auth_next_credentials().  If no more credentials are available,</span>
+<a name="l00677"></a>00677 <span class="comment"> * set @a *credentials to NULL.</span>
+<a name="l00678"></a>00678 <span class="comment"> *</span>
+<a name="l00679"></a>00679 <span class="comment"> * Note that @a *credentials will be allocated in @c auth_baton&#39;s pool.</span>
+<a name="l00680"></a>00680 <span class="comment"> */</span>
+<a name="l00681"></a>00681 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00682"></a>00682 <a class="code" href="group__auth__fns.html#gab18c2431ea55881ef52b647815600cd3" title="Get another set of credentials, assuming previous ones failed to authenticate.">svn_auth_next_credentials</a>(<span class="keywordtype">void</span> **credentials,
+<a name="l00683"></a>00683                           <a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> *state,
+<a name="l00684"></a>00684                           apr_pool_t *pool);
+<a name="l00685"></a>00685 <span class="comment"></span>
+<a name="l00686"></a>00686 <span class="comment">/** Save a set of credentials.</span>
+<a name="l00687"></a>00687 <span class="comment"> *</span>
+<a name="l00688"></a>00688 <span class="comment"> * Ask @a state to store the most recently returned credentials,</span>
+<a name="l00689"></a>00689 <span class="comment"> * presumably because they successfully authenticated.</span>
+<a name="l00690"></a>00690 <span class="comment"> * All allocations should be done in @a pool.</span>
+<a name="l00691"></a>00691 <span class="comment"> *</span>
+<a name="l00692"></a>00692 <span class="comment"> * If no credentials were ever returned, do nothing.</span>
+<a name="l00693"></a>00693 <span class="comment"> */</span>
+<a name="l00694"></a>00694 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00695"></a>00695 <a class="code" href="group__auth__fns.html#gae4a43aa4ab0d4a9baf603bf7f96ec919" title="Save a set of credentials.">svn_auth_save_credentials</a>(<a class="code" href="group__auth__fns.html#ga1ac4eb8d42d56257c6ba607f976b2979" title="The type of a Subversion authentication-iteration object.">svn_auth_iterstate_t</a> *state,
+<a name="l00696"></a>00696                           apr_pool_t *pool);
+<a name="l00697"></a>00697 <span class="comment"></span>
+<a name="l00698"></a>00698 <span class="comment">/** Forget a set (or all) memory-cached credentials.</span>
+<a name="l00699"></a>00699 <span class="comment"> *</span>
+<a name="l00700"></a>00700 <span class="comment"> * Remove references (if any) in @a auth_baton to credentials cached</span>
+<a name="l00701"></a>00701 <span class="comment"> * therein.  If @a cred_kind and @a realmstring are non-NULL, forget</span>
+<a name="l00702"></a>00702 <span class="comment"> * only the credentials associated with those credential types and</span>
+<a name="l00703"></a>00703 <span class="comment"> * realm.  Otherwise @a cred_kind and @a realmstring must both be</span>
+<a name="l00704"></a>00704 <span class="comment"> * NULL, and this function will forget all credentials cached within</span>
+<a name="l00705"></a>00705 <span class="comment"> * @a auth_baton.</span>
+<a name="l00706"></a>00706 <span class="comment"> *</span>
+<a name="l00707"></a>00707 <span class="comment"> * @note This function does not affect persisted authentication</span>
+<a name="l00708"></a>00708 <span class="comment"> * credential storage at all.  It is merely a way to cause Subversion</span>
+<a name="l00709"></a>00709 <span class="comment"> * to forget about credentials already fetched from a provider,</span>
+<a name="l00710"></a>00710 <span class="comment"> * forcing them to be fetched again later should they be required.</span>
+<a name="l00711"></a>00711 <span class="comment"> *</span>
+<a name="l00712"></a>00712 <span class="comment"> * @since New in 1.8.</span>
+<a name="l00713"></a>00713 <span class="comment"> */</span>
+<a name="l00714"></a>00714 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00715"></a>00715 <a class="code" href="group__auth__fns.html#gaa1581f354af47a824044480e11129a22" title="Forget a set (or all) memory-cached credentials.">svn_auth_forget_credentials</a>(<a class="code" href="group__auth__fns.html#gaa77a422f326606f52366fb2fb0a43f8d" title="The type of a Subversion authentication object.">svn_auth_baton_t</a> *auth_baton,
+<a name="l00716"></a>00716                             <span class="keyword">const</span> <span class="keywordtype">char</span> *cred_kind,
+<a name="l00717"></a>00717                             <span class="keyword">const</span> <span class="keywordtype">char</span> *realmstring,
+<a name="l00718"></a>00718                             apr_pool_t *pool);
+<a name="l00719"></a>00719 <span class="comment"></span>
+<a name="l00720"></a>00720 <span class="comment">/** @} */</span>
+<a name="l00721"></a>00721 <span class="comment"></span>
+<a name="l00722"></a>00722 <span class="comment">/** Set @a *provider to an authentication provider of type</span>
+<a name="l00723"></a>00723 <span class="comment"> * svn_auth_cred_simple_t that gets information by prompting the user</span>
+<a name="l00724"></a>00724 <span class="comment"> * with @a prompt_func and @a prompt_baton.  Allocate @a *provider in</span>
+<a name="l00725"></a>00725 <span class="comment"> * @a pool.</span>
+<a name="l00726"></a>00726 <span class="comment"> *</span>
+<a name="l00727"></a>00727 <span class="comment"> * If both @c SVN_AUTH_PARAM_DEFAULT_USERNAME and</span>
+<a name="l00728"></a>00728 <span class="comment"> * @c SVN_AUTH_PARAM_DEFAULT_PASSWORD are defined as runtime</span>
+<a name="l00729"></a>00729 <span class="comment"> * parameters in the @c auth_baton, then @a *provider will return the</span>
+<a name="l00730"></a>00730 <span class="comment"> * default arguments when svn_auth_first_credentials() is called.  If</span>
+<a name="l00731"></a>00731 <span class="comment"> * svn_auth_first_credentials() fails, then @a *provider will</span>
+<a name="l00732"></a>00732 <span class="comment"> * re-prompt @a retry_limit times (via svn_auth_next_credentials()).</span>
+<a name="l00733"></a>00733 <span class="comment"> * For infinite retries, set @a retry_limit to value less than 0.</span>
+<a name="l00734"></a>00734 <span class="comment"> *</span>
+<a name="l00735"></a>00735 <span class="comment"> * @since New in 1.4.</span>
+<a name="l00736"></a>00736 <span class="comment"> */</span>
+<a name="l00737"></a>00737 <span class="keywordtype">void</span>
+<a name="l00738"></a>00738 <a class="code" href="svn__auth_8h.html#a0d1cf74b8f9e2f55a92f1be7a942adb3" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets information by p...">svn_auth_get_simple_prompt_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00739"></a>00739                                     <a class="code" href="group__auth__fns.html#gab3e889e27559677e7e1a13a9142a381d" title="Credential-constructing prompt functions.">svn_auth_simple_prompt_func_t</a> prompt_func,
+<a name="l00740"></a>00740                                     <span class="keywordtype">void</span> *prompt_baton,
+<a name="l00741"></a>00741                                     <span class="keywordtype">int</span> retry_limit,
+<a name="l00742"></a>00742                                     apr_pool_t *pool);
+<a name="l00743"></a>00743 
+<a name="l00744"></a>00744 <span class="comment"></span>
+<a name="l00745"></a>00745 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
+<a name="l00746"></a>00746 <span class="comment"> * svn_auth_cred_username_t that gets information by prompting the</span>
+<a name="l00747"></a>00747 <span class="comment"> * user with @a prompt_func and @a prompt_baton.  Allocate @a *provider</span>
+<a name="l00748"></a>00748 <span class="comment"> * in @a pool.</span>
+<a name="l00749"></a>00749 <span class="comment"> *</span>
+<a name="l00750"></a>00750 <span class="comment"> * If @c SVN_AUTH_PARAM_DEFAULT_USERNAME is defined as a runtime</span>
+<a name="l00751"></a>00751 <span class="comment"> * parameter in the @c auth_baton, then @a *provider will return the</span>
+<a name="l00752"></a>00752 <span class="comment"> * default argument when svn_auth_first_credentials() is called.  If</span>
+<a name="l00753"></a>00753 <span class="comment"> * svn_auth_first_credentials() fails, then @a *provider will</span>
+<a name="l00754"></a>00754 <span class="comment"> * re-prompt @a retry_limit times (via svn_auth_next_credentials()).</span>
+<a name="l00755"></a>00755 <span class="comment"> * For infinite retries, set @a retry_limit to value less than 0.</span>
+<a name="l00756"></a>00756 <span class="comment"> *</span>
+<a name="l00757"></a>00757 <span class="comment"> * @since New in 1.4.</span>
+<a name="l00758"></a>00758 <span class="comment"> */</span>
+<a name="l00759"></a>00759 <span class="keywordtype">void</span>
+<a name="l00760"></a>00760 <a class="code" href="svn__auth_8h.html#a99da7f5d7e4b64aadaed2b94d958aebb" title="Set *provider to an authentication provider of type svn_auth_cred_username_t that gets information by...">svn_auth_get_username_prompt_provider</a>(
+<a name="l00761"></a>00761   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00762"></a>00762   <a class="code" href="group__auth__fns.html#gaf05167cb101739421c2e9542e27d5a88" title="Set *cred by prompting the user, allocating *cred in pool.">svn_auth_username_prompt_func_t</a> prompt_func,
+<a name="l00763"></a>00763   <span class="keywordtype">void</span> *prompt_baton,
+<a name="l00764"></a>00764   <span class="keywordtype">int</span> retry_limit,
+<a name="l00765"></a>00765   apr_pool_t *pool);
+<a name="l00766"></a>00766 
+<a name="l00767"></a>00767 <span class="comment"></span>
+<a name="l00768"></a>00768 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
+<a name="l00769"></a>00769 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
+<a name="l00770"></a>00770 <span class="comment"> * ~/.subversion configuration directory.</span>
+<a name="l00771"></a>00771 <span class="comment"> *</span>
+<a name="l00772"></a>00772 <span class="comment"> * If the provider is going to save the password unencrypted, it calls @a</span>
+<a name="l00773"></a>00773 <span class="comment"> * plaintext_prompt_func, passing @a prompt_baton, before saving the</span>
+<a name="l00774"></a>00774 <span class="comment"> * password.</span>
+<a name="l00775"></a>00775 <span class="comment"> *</span>
+<a name="l00776"></a>00776 <span class="comment"> * If @a plaintext_prompt_func is NULL it is not called and the answer is</span>
+<a name="l00777"></a>00777 <span class="comment"> * assumed to be TRUE. This matches the deprecated behaviour of storing</span>
+<a name="l00778"></a>00778 <span class="comment"> * unencrypted passwords by default, and is only done this way for backward</span>
+<a name="l00779"></a>00779 <span class="comment"> * compatibility reasons.</span>
+<a name="l00780"></a>00780 <span class="comment"> * Client developers are highly encouraged to provide this callback</span>
+<a name="l00781"></a>00781 <span class="comment"> * to ensure their users are made aware of the fact that their password</span>
+<a name="l00782"></a>00782 <span class="comment"> * is going to be stored unencrypted. In the future, providers may</span>
+<a name="l00783"></a>00783 <span class="comment"> * default to not storing the password unencrypted if this callback is NULL.</span>
 <a name="l00784"></a>00784 <span class="comment"> *</span>
-<a name="l00785"></a>00785 <span class="comment"> * If a default username or password is available, @a *provider will</span>
-<a name="l00786"></a>00786 <span class="comment"> * honor them as well, and return them when</span>
-<a name="l00787"></a>00787 <span class="comment"> * svn_auth_first_credentials() is called.  (see @c</span>
-<a name="l00788"></a>00788 <span class="comment"> * SVN_AUTH_PARAM_DEFAULT_USERNAME and @c</span>
-<a name="l00789"></a>00789 <span class="comment"> * SVN_AUTH_PARAM_DEFAULT_PASSWORD).</span>
+<a name="l00785"></a>00785 <span class="comment"> * Clients can however set the callback to NULL and set</span>
+<a name="l00786"></a>00786 <span class="comment"> * SVN_AUTH_PARAM_STORE_PLAINTEXT_PASSWORDS to SVN_CONFIG_FALSE or</span>
+<a name="l00787"></a>00787 <span class="comment"> * SVN_CONFIG_TRUE to enforce a certain behaviour.</span>
+<a name="l00788"></a>00788 <span class="comment"> *</span>
+<a name="l00789"></a>00789 <span class="comment"> * Allocate @a *provider in @a pool.</span>
 <a name="l00790"></a>00790 <span class="comment"> *</span>
-<a name="l00791"></a>00791 <span class="comment"> * @since New in 1.6.</span>
-<a name="l00792"></a>00792 <span class="comment"> */</span>
-<a name="l00793"></a>00793 <span class="keywordtype">void</span>
-<a name="l00794"></a>00794 <a class="code" href="svn__auth_8h.html#adbe6e4f9a56ed5108f06f95d40b8042e" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_simple_provider2</a>(
-<a name="l00795"></a>00795   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00796"></a>00796   <a class="code" href="group__auth__fns.html#gad411a1955468c3efac5f823cb437681f" title="A type of callback function for asking whether storing a password to disk in plaintext is allowed...">svn_auth_plaintext_prompt_func_t</a> plaintext_prompt_func,
-<a name="l00797"></a>00797   <span class="keywordtype">void</span> *prompt_baton,
-<a name="l00798"></a>00798   apr_pool_t *pool);
-<a name="l00799"></a>00799 <span class="comment"></span>
-<a name="l00800"></a>00800 <span class="comment">/** Like svn_auth_get_simple_provider2, but without the ability to</span>
-<a name="l00801"></a>00801 <span class="comment"> * call the svn_auth_plaintext_prompt_func_t callback, and the provider</span>
-<a name="l00802"></a>00802 <span class="comment"> * always assumes that it is allowed to store the password in plaintext.</span>
-<a name="l00803"></a>00803 <span class="comment"> *</span>
-<a name="l00804"></a>00804 <span class="comment"> * @deprecated Provided for backwards compatibility with the 1.5 API.</span>
-<a name="l00805"></a>00805 <span class="comment"> * @since New in 1.4.</span>
-<a name="l00806"></a>00806 <span class="comment"> */</span>
-<a name="l00807"></a>00807 SVN_DEPRECATED
-<a name="l00808"></a>00808 <span class="keywordtype">void</span>
-<a name="l00809"></a>00809 <a class="code" href="svn__auth_8h.html#a7046599e07079f36f7a2845eeb537ca5" title="Like svn_auth_get_simple_provider2, but without the ability to call the svn_auth_plaintext_prompt_fun...">svn_auth_get_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00810"></a>00810                              apr_pool_t *pool);
-<a name="l00811"></a>00811 <span class="comment"></span>
-<a name="l00812"></a>00812 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
-<a name="l00813"></a>00813 <span class="comment"> * svn_auth_provider_object_t, or return @c NULL if the provider is not</span>
-<a name="l00814"></a>00814 <span class="comment"> * available for the requested platform or the requested provider is unknown.</span>
-<a name="l00815"></a>00815 <span class="comment"> *</span>
-<a name="l00816"></a>00816 <span class="comment"> * Valid @a provider_name values are: &quot;gnome_keyring&quot;, &quot;keychain&quot;, &quot;kwallet&quot;,</span>
-<a name="l00817"></a>00817 <span class="comment"> * &quot;gpg_agent&quot;, and &quot;windows&quot;.</span>
-<a name="l00818"></a>00818 <span class="comment"> *</span>
-<a name="l00819"></a>00819 <span class="comment"> * Valid @a provider_type values are: &quot;simple&quot;, &quot;ssl_client_cert_pw&quot; and</span>
-<a name="l00820"></a>00820 <span class="comment"> * &quot;ssl_server_trust&quot;.</span>
+<a name="l00791"></a>00791 <span class="comment"> * If a default username or password is available, @a *provider will</span>
+<a name="l00792"></a>00792 <span class="comment"> * honor them as well, and return them when</span>
+<a name="l00793"></a>00793 <span class="comment"> * svn_auth_first_credentials() is called.  (see @c</span>
+<a name="l00794"></a>00794 <span class="comment"> * SVN_AUTH_PARAM_DEFAULT_USERNAME and @c</span>
+<a name="l00795"></a>00795 <span class="comment"> * SVN_AUTH_PARAM_DEFAULT_PASSWORD).</span>
+<a name="l00796"></a>00796 <span class="comment"> *</span>
+<a name="l00797"></a>00797 <span class="comment"> * @since New in 1.6.</span>
+<a name="l00798"></a>00798 <span class="comment"> */</span>
+<a name="l00799"></a>00799 <span class="keywordtype">void</span>
+<a name="l00800"></a>00800 <a class="code" href="svn__auth_8h.html#adbe6e4f9a56ed5108f06f95d40b8042e" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_simple_provider2</a>(
+<a name="l00801"></a>00801   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00802"></a>00802   <a class="code" href="group__auth__fns.html#gad411a1955468c3efac5f823cb437681f" title="A type of callback function for asking whether storing a password to disk in plaintext is allowed...">svn_auth_plaintext_prompt_func_t</a> plaintext_prompt_func,
+<a name="l00803"></a>00803   <span class="keywordtype">void</span> *prompt_baton,
+<a name="l00804"></a>00804   apr_pool_t *pool);
+<a name="l00805"></a>00805 <span class="comment"></span>
+<a name="l00806"></a>00806 <span class="comment">/** Like svn_auth_get_simple_provider2, but without the ability to</span>
+<a name="l00807"></a>00807 <span class="comment"> * call the svn_auth_plaintext_prompt_func_t callback, and the provider</span>
+<a name="l00808"></a>00808 <span class="comment"> * always assumes that it is allowed to store the password in plaintext.</span>
+<a name="l00809"></a>00809 <span class="comment"> *</span>
+<a name="l00810"></a>00810 <span class="comment"> * @deprecated Provided for backwards compatibility with the 1.5 API.</span>
+<a name="l00811"></a>00811 <span class="comment"> * @since New in 1.4.</span>
+<a name="l00812"></a>00812 <span class="comment"> */</span>
+<a name="l00813"></a>00813 SVN_DEPRECATED
+<a name="l00814"></a>00814 <span class="keywordtype">void</span>
+<a name="l00815"></a>00815 <a class="code" href="svn__auth_8h.html#a7046599e07079f36f7a2845eeb537ca5" title="Like svn_auth_get_simple_provider2, but without the ability to call the svn_auth_plaintext_prompt_fun...">svn_auth_get_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00816"></a>00816                              apr_pool_t *pool);
+<a name="l00817"></a>00817 <span class="comment"></span>
+<a name="l00818"></a>00818 <span class="comment">/** Set @a *provider to an authentication provider of type @c</span>
+<a name="l00819"></a>00819 <span class="comment"> * svn_auth_provider_object_t, or return @c NULL if the provider is not</span>
+<a name="l00820"></a>00820 <span class="comment"> * available for the requested platform or the requested provider is unknown.</span>
 <a name="l00821"></a>00821 <span class="comment"> *</span>
-<a name="l00822"></a>00822 <span class="comment"> * Allocate @a *provider in @a pool.</span>
-<a name="l00823"></a>00823 <span class="comment"> *</span>
-<a name="l00824"></a>00824 <span class="comment"> * What actually happens is we invoke the appropriate provider function to</span>
-<a name="l00825"></a>00825 <span class="comment"> * supply the @a provider, like so:</span>
-<a name="l00826"></a>00826 <span class="comment"> *</span>
-<a name="l00827"></a>00827 <span class="comment"> *    svn_auth_get_&lt;name&gt;_&lt;type&gt;_provider(@a provider, @a pool);</span>
-<a name="l00828"></a>00828 <span class="comment"> *</span>
-<a name="l00829"></a>00829 <span class="comment"> * @since New in 1.6.</span>
-<a name="l00830"></a>00830 <span class="comment"> */</span>
-<a name="l00831"></a>00831 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00832"></a>00832 <a class="code" href="svn__auth_8h.html#a0efdc798365a84b0416f12e861b04831" title="Set *provider to an authentication provider of type svn_auth_provider_object_t, or return NULL if the...">svn_auth_get_platform_specific_provider</a>(
-<a name="l00833"></a>00833   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00834"></a>00834   <span class="keyword">const</span> <span class="keywordtype">char</span> *provider_name,
-<a name="l00835"></a>00835   <span class="keyword">const</span> <span class="keywordtype">char</span> *provider_type,
-<a name="l00836"></a>00836   apr_pool_t *pool);
-<a name="l00837"></a>00837 <span class="comment"></span>
-<a name="l00838"></a>00838 <span class="comment">/** Set @a *providers to an array of &lt;tt&gt;svn_auth_provider_object_t *&lt;/tt&gt;</span>
-<a name="l00839"></a>00839 <span class="comment"> * objects.</span>
-<a name="l00840"></a>00840 <span class="comment"> * Only client authentication providers available for the current platform are</span>
-<a name="l00841"></a>00841 <span class="comment"> * returned. Order of the platform-specific authentication providers is</span>
-<a name="l00842"></a>00842 <span class="comment"> * determined by the &#39;password-stores&#39; configuration option which is retrieved</span>
-<a name="l00843"></a>00843 <span class="comment"> * from @a config. @a config can be NULL.</span>
-<a name="l00844"></a>00844 <span class="comment"> *</span>
-<a name="l00845"></a>00845 <span class="comment"> * Create and allocate @a *providers in @a pool.</span>
-<a name="l00846"></a>00846 <span class="comment"> *</span>
-<a name="l00847"></a>00847 <span class="comment"> * Default order of the platform-specific authentication providers:</span>
-<a name="l00848"></a>00848 <span class="comment"> *   1. gnome-keyring</span>
-<a name="l00849"></a>00849 <span class="comment"> *   2. kwallet</span>
-<a name="l00850"></a>00850 <span class="comment"> *   3. keychain</span>
-<a name="l00851"></a>00851 <span class="comment"> *   4. gpg-agent</span>
-<a name="l00852"></a>00852 <span class="comment"> *   5. windows-cryptoapi</span>
-<a name="l00853"></a>00853 <span class="comment"> *</span>
-<a name="l00854"></a>00854 <span class="comment"> * @since New in 1.6.</span>
-<a name="l00855"></a>00855 <span class="comment"> */</span>
-<a name="l00856"></a>00856 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00857"></a>00857 <a class="code" href="svn__auth_8h.html#acc9973cdd97aa3dec04569827a328c8e" title="Set *providers to an array of svn_auth_provider_object_t * objects.">svn_auth_get_platform_specific_client_providers</a>(
-<a name="l00858"></a>00858   apr_array_header_t **providers,
-<a name="l00859"></a>00859   <a class="code" href="svn__config_8h.html#aab78e7d9b95c9bcfe0bdf1d9f3212596" title="Opaque structure describing a set of configuration options.">svn_config_t</a> *config,
-<a name="l00860"></a>00860   apr_pool_t *pool);
-<a name="l00861"></a>00861 
-<a name="l00862"></a>00862 <span class="preprocessor">#if (defined(WIN32) &amp;&amp; !defined(__MINGW32__)) || defined(DOXYGEN)</span>
-<a name="l00863"></a>00863 <span class="preprocessor"></span><span class="comment">/**</span>
-<a name="l00864"></a>00864 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l00865"></a>00865 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l00866"></a>00866 <span class="comment"> * ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l00867"></a>00867 <span class="comment"> * @a pool.</span>
-<a name="l00868"></a>00868 <span class="comment"> *</span>
-<a name="l00869"></a>00869 <span class="comment"> * This is like svn_auth_get_simple_provider(), except that, when</span>
-<a name="l00870"></a>00870 <span class="comment"> * running on Window 2000 or newer (or any other Windows version that</span>
-<a name="l00871"></a>00871 <span class="comment"> * includes the CryptoAPI), the provider encrypts the password before</span>
-<a name="l00872"></a>00872 <span class="comment"> * storing it to disk. On earlier versions of Windows, the provider</span>
-<a name="l00873"></a>00873 <span class="comment"> * does nothing.</span>
+<a name="l00822"></a>00822 <span class="comment"> * Valid @a provider_name values are: &quot;gnome_keyring&quot;, &quot;keychain&quot;, &quot;kwallet&quot;,</span>
+<a name="l00823"></a>00823 <span class="comment"> * &quot;gpg_agent&quot;, and &quot;windows&quot;.</span>
+<a name="l00824"></a>00824 <span class="comment"> *</span>
+<a name="l00825"></a>00825 <span class="comment"> * Valid @a provider_type values are: &quot;simple&quot;, &quot;ssl_client_cert_pw&quot; and</span>
+<a name="l00826"></a>00826 <span class="comment"> * &quot;ssl_server_trust&quot;.</span>
+<a name="l00827"></a>00827 <span class="comment"> *</span>
+<a name="l00828"></a>00828 <span class="comment"> * Allocate @a *provider in @a pool.</span>
+<a name="l00829"></a>00829 <span class="comment"> *</span>
+<a name="l00830"></a>00830 <span class="comment"> * What actually happens is we invoke the appropriate provider function to</span>
+<a name="l00831"></a>00831 <span class="comment"> * supply the @a provider, like so:</span>
+<a name="l00832"></a>00832 <span class="comment"> *</span>
+<a name="l00833"></a>00833 <span class="comment"> *    svn_auth_get_&lt;name&gt;_&lt;type&gt;_provider(@a provider, @a pool);</span>
+<a name="l00834"></a>00834 <span class="comment"> *</span>
+<a name="l00835"></a>00835 <span class="comment"> * @since New in 1.6.</span>
+<a name="l00836"></a>00836 <span class="comment"> */</span>
+<a name="l00837"></a>00837 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00838"></a>00838 <a class="code" href="svn__auth_8h.html#a0efdc798365a84b0416f12e861b04831" title="Set *provider to an authentication provider of type svn_auth_provider_object_t, or return NULL if the...">svn_auth_get_platform_specific_provider</a>(
+<a name="l00839"></a>00839   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00840"></a>00840   <span class="keyword">const</span> <span class="keywordtype">char</span> *provider_name,
+<a name="l00841"></a>00841   <span class="keyword">const</span> <span class="keywordtype">char</span> *provider_type,
+<a name="l00842"></a>00842   apr_pool_t *pool);
+<a name="l00843"></a>00843 <span class="comment"></span>
+<a name="l00844"></a>00844 <span class="comment">/** Set @a *providers to an array of &lt;tt&gt;svn_auth_provider_object_t *&lt;/tt&gt;</span>
+<a name="l00845"></a>00845 <span class="comment"> * objects.</span>
+<a name="l00846"></a>00846 <span class="comment"> * Only client authentication providers available for the current platform are</span>
+<a name="l00847"></a>00847 <span class="comment"> * returned. Order of the platform-specific authentication providers is</span>
+<a name="l00848"></a>00848 <span class="comment"> * determined by the &#39;password-stores&#39; configuration option which is retrieved</span>
+<a name="l00849"></a>00849 <span class="comment"> * from @a config. @a config can be NULL.</span>
+<a name="l00850"></a>00850 <span class="comment"> *</span>
+<a name="l00851"></a>00851 <span class="comment"> * Create and allocate @a *providers in @a pool.</span>
+<a name="l00852"></a>00852 <span class="comment"> *</span>
+<a name="l00853"></a>00853 <span class="comment"> * Default order of the platform-specific authentication providers:</span>
+<a name="l00854"></a>00854 <span class="comment"> *   1. gnome-keyring</span>
+<a name="l00855"></a>00855 <span class="comment"> *   2. kwallet</span>
+<a name="l00856"></a>00856 <span class="comment"> *   3. keychain</span>
+<a name="l00857"></a>00857 <span class="comment"> *   4. gpg-agent</span>
+<a name="l00858"></a>00858 <span class="comment"> *   5. windows-cryptoapi</span>
+<a name="l00859"></a>00859 <span class="comment"> *</span>
+<a name="l00860"></a>00860 <span class="comment"> * @since New in 1.6.</span>
+<a name="l00861"></a>00861 <span class="comment"> */</span>
+<a name="l00862"></a>00862 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00863"></a>00863 <a class="code" href="svn__auth_8h.html#acc9973cdd97aa3dec04569827a328c8e" title="Set *providers to an array of svn_auth_provider_object_t * objects.">svn_auth_get_platform_specific_client_providers</a>(
+<a name="l00864"></a>00864   apr_array_header_t **providers,
+<a name="l00865"></a>00865   <a class="code" href="svn__config_8h.html#aab78e7d9b95c9bcfe0bdf1d9f3212596" title="Opaque structure describing a set of configuration options.">svn_config_t</a> *config,
+<a name="l00866"></a>00866   apr_pool_t *pool);
+<a name="l00867"></a>00867 
+<a name="l00868"></a>00868 <span class="preprocessor">#if (defined(WIN32) &amp;&amp; !defined(__MINGW32__)) || defined(DOXYGEN)</span>
+<a name="l00869"></a>00869 <span class="preprocessor"></span><span class="comment">/**</span>
+<a name="l00870"></a>00870 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
+<a name="l00871"></a>00871 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
+<a name="l00872"></a>00872 <span class="comment"> * ~/.subversion configuration directory.  Allocate @a *provider in</span>
+<a name="l00873"></a>00873 <span class="comment"> * @a pool.</span>
 <a name="l00874"></a>00874 <span class="comment"> *</span>
-<a name="l00875"></a>00875 <span class="comment"> * @since New in 1.4.</span>
-<a name="l00876"></a>00876 <span class="comment"> * @note This function is only available on Windows.</span>
-<a name="l00877"></a>00877 <span class="comment"> *</span>
-<a name="l00878"></a>00878 <span class="comment"> * @note An administrative password reset may invalidate the account&#39;s</span>
-<a name="l00879"></a>00879 <span class="comment"> * secret key. This function will detect that situation and behave as</span>
-<a name="l00880"></a>00880 <span class="comment"> * if the password were not cached at all.</span>
-<a name="l00881"></a>00881 <span class="comment"> */</span>
-<a name="l00882"></a>00882 <span class="keywordtype">void</span>
-<a name="l00883"></a>00883 <a class="code" href="svn__auth_8h.html#a150ee5110b383bcdb2ce9b341dc26798" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_windows_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00884"></a>00884                                      apr_pool_t *pool);
-<a name="l00885"></a>00885 <span class="comment"></span>
-<a name="l00886"></a>00886 <span class="comment">/**</span>
-<a name="l00887"></a>00887 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l00888"></a>00888 <span class="comment"> * svn_auth_cred_ssl_client_cert_pw_t that gets/sets information from the</span>
-<a name="l00889"></a>00889 <span class="comment"> * user&#39;s ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l00890"></a>00890 <span class="comment"> * @a pool.</span>
-<a name="l00891"></a>00891 <span class="comment"> *</span>
-<a name="l00892"></a>00892 <span class="comment"> * This is like svn_auth_get_ssl_client_cert_pw_file_provider(), except that</span>
-<a name="l00893"></a>00893 <span class="comment"> * when running on Window 2000 or newer, the provider encrypts the password</span>
-<a name="l00894"></a>00894 <span class="comment"> * before storing it to disk. On earlier versions of Windows, the provider</span>
-<a name="l00895"></a>00895 <span class="comment"> * does nothing.</span>
-<a name="l00896"></a>00896 <span class="comment"> *</span>
-<a name="l00897"></a>00897 <span class="comment"> * @since New in 1.6</span>
-<a name="l00898"></a>00898 <span class="comment"> * @note This function is only available on Windows.</span>
-<a name="l00899"></a>00899 <span class="comment"> *</span>
-<a name="l00900"></a>00900 <span class="comment"> * @note An administrative password reset may invalidate the account&#39;s</span>
-<a name="l00901"></a>00901 <span class="comment"> * secret key. This function will detect that situation and behave as</span>
-<a name="l00902"></a>00902 <span class="comment"> * if the password were not cached at all.</span>
-<a name="l00903"></a>00903 <span class="comment"> */</span>
-<a name="l00904"></a>00904 <span class="keywordtype">void</span>
-<a name="l00905"></a>00905 <a class="code" href="svn__auth_8h.html#a727c53b91e8d6b2d1d140b38e19f4d60" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_client_cert_pw_t that gets/sets...">svn_auth_get_windows_ssl_client_cert_pw_provider</a>(
-<a name="l00906"></a>00906   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00907"></a>00907   apr_pool_t *pool);
-<a name="l00908"></a>00908 <span class="comment"></span>
-<a name="l00909"></a>00909 <span class="comment">/**</span>
-<a name="l00910"></a>00910 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l00911"></a>00911 <span class="comment"> * svn_auth_cred_ssl_server_trust_t, allocated in @a pool.</span>
-<a name="l00912"></a>00912 <span class="comment"> *</span>
-<a name="l00913"></a>00913 <span class="comment"> * This provider automatically validates ssl server certificates with</span>
-<a name="l00914"></a>00914 <span class="comment"> * the CryptoApi, like Internet Explorer and the Windows network API do.</span>
-<a name="l00915"></a>00915 <span class="comment"> * This allows the rollout of root certificates via Windows Domain</span>
-<a name="l00916"></a>00916 <span class="comment"> * policies, instead of Subversion specific configuration.</span>
-<a name="l00917"></a>00917 <span class="comment"> *</span>
-<a name="l00918"></a>00918 <span class="comment"> * @since New in 1.5.</span>
-<a name="l00919"></a>00919 <span class="comment"> * @note This function is only available on Windows.</span>
-<a name="l00920"></a>00920 <span class="comment"> */</span>
-<a name="l00921"></a>00921 <span class="keywordtype">void</span>
-<a name="l00922"></a>00922 <a class="code" href="svn__auth_8h.html#aba0697d924aebb6d00a7a0fa40965161" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_server_trust_t, allocated in pool.">svn_auth_get_windows_ssl_server_trust_provider</a>(
-<a name="l00923"></a>00923   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00924"></a>00924   apr_pool_t *pool);
-<a name="l00925"></a>00925 
-<a name="l00926"></a>00926 <span class="preprocessor">#endif </span><span class="comment">/* WIN32 &amp;&amp; !__MINGW32__ || DOXYGEN */</span>
-<a name="l00927"></a>00927 
-<a name="l00928"></a>00928 <span class="preprocessor">#if defined(DARWIN) || defined(DOXYGEN)</span>
-<a name="l00929"></a>00929 <span class="preprocessor"></span><span class="comment">/**</span>
-<a name="l00930"></a>00930 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l00931"></a>00931 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l00932"></a>00932 <span class="comment"> * ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l00933"></a>00933 <span class="comment"> * @a pool.</span>
-<a name="l00934"></a>00934 <span class="comment"> *</span>
-<a name="l00935"></a>00935 <span class="comment"> * This is like svn_auth_get_simple_provider(), except that the</span>
-<a name="l00936"></a>00936 <span class="comment"> * password is stored in the Mac OS KeyChain.</span>
-<a name="l00937"></a>00937 <span class="comment"> *</span>
-<a name="l00938"></a>00938 <span class="comment"> * @since New in 1.4</span>
-<a name="l00939"></a>00939 <span class="comment"> * @note This function is only available on Mac OS 10.2 and higher.</span>
-<a name="l00940"></a>00940 <span class="comment"> */</span>
-<a name="l00941"></a>00941 <span class="keywordtype">void</span>
-<a name="l00942"></a>00942 <a class="code" href="svn__auth_8h.html#a412a3c955d7aadd3bd41f54fccf2adcd" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_keychain_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00943"></a>00943                                       apr_pool_t *pool);
-<a name="l00944"></a>00944 <span class="comment"></span>
-<a name="l00945"></a>00945 <span class="comment">/**</span>
-<a name="l00946"></a>00946 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l00947"></a>00947 <span class="comment"> * svn_auth_cred_ssl_client_cert_pw_t that gets/sets information from the</span>
-<a name="l00948"></a>00948 <span class="comment"> * user&#39;s ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l00949"></a>00949 <span class="comment"> * @a pool.</span>
-<a name="l00950"></a>00950 <span class="comment"> *</span>
-<a name="l00951"></a>00951 <span class="comment"> * This is like svn_auth_get_ssl_client_cert_pw_file_provider(), except</span>
-<a name="l00952"></a>00952 <span class="comment"> * that the password is stored in the Mac OS KeyChain.</span>
-<a name="l00953"></a>00953 <span class="comment"> *</span>
-<a name="l00954"></a>00954 <span class="comment"> * @since New in 1.6</span>
-<a name="l00955"></a>00955 <span class="comment"> * @note This function is only available on Mac OS 10.2 and higher.</span>
-<a name="l00956"></a>00956 <span class="comment"> */</span>
-<a name="l00957"></a>00957 <span class="keywordtype">void</span>
-<a name="l00958"></a>00958 <a class="code" href="svn__auth_8h.html#af243bf165ca0b72faf205e8ebba46f00" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_client_cert_pw_t that gets/sets...">svn_auth_get_keychain_ssl_client_cert_pw_provider</a>(
-<a name="l00959"></a>00959   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l00960"></a>00960   apr_pool_t *pool);
-<a name="l00961"></a>00961 <span class="preprocessor">#endif </span><span class="comment">/* DARWIN || DOXYGEN */</span>
-<a name="l00962"></a>00962 
-<a name="l00963"></a>00963 <span class="preprocessor">#if (!defined(DARWIN) &amp;&amp; !defined(WIN32)) || defined(DOXYGEN)</span>
-<a name="l00964"></a>00964 <span class="preprocessor"></span><span class="comment">/** A type of callback function for obtaining the GNOME Keyring password.</span>
-<a name="l00965"></a>00965 <span class="comment"> *</span>
-<a name="l00966"></a>00966 <span class="comment"> * In this callback, the client should ask the user for default keyring</span>
-<a name="l00967"></a>00967 <span class="comment"> * @a keyring_name password.</span>
-<a name="l00968"></a>00968 <span class="comment"> *</span>
-<a name="l00969"></a>00969 <span class="comment"> * The answer is returned in @a *keyring_password.</span>
-<a name="l00970"></a>00970 <span class="comment"> * @a baton is an implementation-specific closure.</span>
-<a name="l00971"></a>00971 <span class="comment"> * All allocations should be done in @a pool.</span>
-<a name="l00972"></a>00972 <span class="comment"> *</span>
-<a name="l00973"></a>00973 <span class="comment"> * @since New in 1.6</span>
-<a name="l00974"></a>00974 <span class="comment"> */</span>
-<a name="l00975"></a><a class="code" href="svn__auth_8h.html#a49f569118db893785c861170c9a0ca38">00975</a> <span class="keyword">typedef</span> <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *(*svn_auth_gnome_keyring_unlock_prompt_func_t)(
-<a name="l00976"></a>00976   <span class="keywordtype">char</span> **keyring_password,
-<a name="l00977"></a>00977   <span class="keyword">const</span> <span class="keywordtype">char</span> *keyring_name,
-<a name="l00978"></a>00978   <span class="keywordtype">void</span> *baton,
-<a name="l00979"></a>00979   apr_pool_t *pool);
-<a name="l00980"></a>00980 
-<a name="l00981"></a>00981 <span class="comment"></span>
-<a name="l00982"></a>00982 <span class="comment">/** libsvn_auth_gnome_keyring-specific run-time parameters. */</span>
-<a name="l00983"></a>00983 <span class="comment"></span>
-<a name="l00984"></a>00984 <span class="comment">/** @brief The pointer to function which prompts user for GNOME Keyring</span>
-<a name="l00985"></a>00985 <span class="comment"> * password.</span>
-<a name="l00986"></a>00986 <span class="comment"> * The type of this pointer should be svn_auth_gnome_keyring_unlock_prompt_func_t. */</span>
-<a name="l00987"></a><a class="code" href="svn__auth_8h.html#ae5e28004be0a3c85dce7bf682af76ce2">00987</a> <span class="preprocessor">#define SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC &quot;gnome-keyring-unlock-prompt-func&quot;</span>
-<a name="l00988"></a>00988 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00989"></a>00989 <span class="comment">/** @brief The baton which is passed to</span>
-<a name="l00990"></a>00990 <span class="comment"> * @c *SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC. */</span>
-<a name="l00991"></a><a class="code" href="svn__auth_8h.html#a924cf1863a73cc0ac4b38beea411e046">00991</a> <span class="preprocessor">#define SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_BATON &quot;gnome-keyring-unlock-prompt-baton&quot;</span>
-<a name="l00992"></a>00992 <span class="preprocessor"></span>
-<a name="l00993"></a>00993 <span class="comment"></span>
-<a name="l00994"></a>00994 <span class="comment">/**</span>
-<a name="l00995"></a>00995 <span class="comment"> * Get libsvn_auth_gnome_keyring version information.</span>
-<a name="l00996"></a>00996 <span class="comment"> *</span>
-<a name="l00997"></a>00997 <span class="comment"> * @since New in 1.6</span>
-<a name="l00998"></a>00998 <span class="comment"> */</span>
-<a name="l00999"></a>00999 <span class="keyword">const</span> <a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a> *
-<a name="l01000"></a>01000 <a class="code" href="svn__auth_8h.html#ae9807e72666c1838813f9de3d8cb7373" title="Get libsvn_auth_gnome_keyring version information.">svn_auth_gnome_keyring_version</a>(<span class="keywordtype">void</span>);
-<a name="l01001"></a>01001 
-<a name="l01002"></a>01002 <span class="comment"></span>
-<a name="l01003"></a>01003 <span class="comment">/**</span>
-<a name="l01004"></a>01004 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l01005"></a>01005 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l01006"></a>01006 <span class="comment"> * ~/.subversion configuration directory.</span>
-<a name="l01007"></a>01007 <span class="comment"> *</span>
-<a name="l01008"></a>01008 <span class="comment"> * This is like svn_client_get_simple_provider(), except that the</span>
-<a name="l01009"></a>01009 <span class="comment"> * password is stored in GNOME Keyring.</span>
-<a name="l01010"></a>01010 <span class="comment"> *</span>
-<a name="l01011"></a>01011 <span class="comment"> * If the GNOME Keyring is locked the provider calls</span>
-<a name="l01012"></a>01012 <span class="comment"> * @c *SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC in order to unlock</span>
-<a name="l01013"></a>01013 <span class="comment"> * the keyring.</span>
-<a name="l01014"></a>01014 <span class="comment"> *</span>
-<a name="l01015"></a>01015 <span class="comment"> * @c SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_BATON is passed to</span>
-<a name="l01016"></a>01016 <span class="comment"> * @c *SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC.</span>
-<a name="l01017"></a>01017 <span class="comment"> *</span>
-<a name="l01018"></a>01018 <span class="comment"> * Allocate @a *provider in @a pool.</span>
-<a name="l01019"></a>01019 <span class="comment"> *</span>
-<a name="l01020"></a>01020 <span class="comment"> * @since New in 1.6</span>
-<a name="l01021"></a>01021 <span class="comment"> * @note This function actually works only on systems with</span>
-<a name="l01022"></a>01022 <span class="comment"> * libsvn_auth_gnome_keyring and GNOME Keyring installed.</span>
-<a name="l01023"></a>01023 <span class="comment"> */</span>
-<a name="l01024"></a>01024 <span class="keywordtype">void</span>
-<a name="l01025"></a>01025 <a class="code" href="svn__auth_8h.html#ab8992f1f553f731482eee99b42eedaa6" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_gnome_keyring_simple_provider</a>(
-<a name="l01026"></a>01026   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l01027"></a>01027   apr_pool_t *pool);
-<a name="l01028"></a>01028 
-<a name="l01029"></a>01029 <span class="comment"></span>
-<a name="l01030"></a>01030 <span class="comment">/**</span>
-<a name="l01031"></a>01031 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l01032"></a>01032 <span class="comment"> * svn_auth_cred_ssl_client_cert_pw_t that gets/sets information from the</span>
-<a name="l01033"></a>01033 <span class="comment"> * user&#39;s ~/.subversion configuration directory.</span>
-<a name="l01034"></a>01034 <span class="comment"> *</span>
-<a name="l01035"></a>01035 <span class="comment"> * This is like svn_client_get_ssl_client_cert_pw_file_provider(), except</span>
-<a name="l01036"></a>01036 <span class="comment"> * that the password is stored in GNOME Keyring.</span>
-<a name="l01037"></a>01037 <span class="comment"> *</span>
-<a name="l01038"></a>01038 <span class="comment"> * If the GNOME Keyring is locked the provider calls</span>
-<a name="l01039"></a>01039 <span class="comment"> * @c *SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC in order to unlock</span>
-<a name="l01040"></a>01040 <span class="comment"> * the keyring.</span>
-<a name="l01041"></a>01041 <span class="comment"> *</span>
-<a name="l01042"></a>01042 <span class="comment"> * @c SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_BATON is passed to</span>
-<a name="l01043"></a>01043 <span class="comment"> * @c *SVN_AUTH_PARAM_GNOME_KEYRING_UNLOCK_PROMPT_FUNC.</span>
-<a name="l01044"></a>01044 <span class="comment"> *</span>
-<a name="l01045"></a>01045 <span class="comment"> * Allocate @a *provider in @a pool.</span>
-<a name="l01046"></a>01046 <span class="comment"> *</span>
-<a name="l01047"></a>01047 <span class="comment"> * @since New in 1.6</span>
-<a name="l01048"></a>01048 <span class="comment"> * @note This function actually works only on systems with</span>
-<a name="l01049"></a>01049 <span class="comment"> * libsvn_auth_gnome_keyring and GNOME Keyring installed.</span>
-<a name="l01050"></a>01050 <span class="comment"> */</span>
-<a name="l01051"></a>01051 <span class="keywordtype">void</span>
-<a name="l01052"></a>01052 <a class="code" href="svn__auth_8h.html#a1d2364717fc83a0decd3fa136ae46779" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_client_cert_pw_t that gets/sets...">svn_auth_get_gnome_keyring_ssl_client_cert_pw_provider</a>(
-<a name="l01053"></a>01053   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l01054"></a>01054   apr_pool_t *pool);
-<a name="l01055"></a>01055 
-<a name="l01056"></a>01056 <span class="comment"></span>
-<a name="l01057"></a>01057 <span class="comment">/**</span>
-<a name="l01058"></a>01058 <span class="comment"> * Get libsvn_auth_kwallet version information.</span>
-<a name="l01059"></a>01059 <span class="comment"> *</span>
-<a name="l01060"></a>01060 <span class="comment"> * @since New in 1.6</span>
-<a name="l01061"></a>01061 <span class="comment"> */</span>
-<a name="l01062"></a>01062 <span class="keyword">const</span> <a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a> *
-<a name="l01063"></a>01063 <a class="code" href="svn__auth_8h.html#a204f231da37e0d8de0d2939b41483153" title="Get libsvn_auth_kwallet version information.">svn_auth_kwallet_version</a>(<span class="keywordtype">void</span>);
-<a name="l01064"></a>01064 
-<a name="l01065"></a>01065 <span class="comment"></span>
-<a name="l01066"></a>01066 <span class="comment">/**</span>
-<a name="l01067"></a>01067 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l01068"></a>01068 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l01069"></a>01069 <span class="comment"> * ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l01070"></a>01070 <span class="comment"> * @a pool.</span>
-<a name="l01071"></a>01071 <span class="comment"> *</span>
-<a name="l01072"></a>01072 <span class="comment"> * This is like svn_client_get_simple_provider(), except that the</span>
-<a name="l01073"></a>01073 <span class="comment"> * password is stored in KWallet.</span>
-<a name="l01074"></a>01074 <span class="comment"> *</span>
-<a name="l01075"></a>01075 <span class="comment"> * @since New in 1.6</span>
-<a name="l01076"></a>01076 <span class="comment"> * @note This function actually works only on systems with libsvn_auth_kwallet</span>
-<a name="l01077"></a>01077 <span class="comment"> * and KWallet installed.</span>
-<a name="l01078"></a>01078 <span class="comment"> */</span>
-<a name="l01079"></a>01079 <span class="keywordtype">void</span>
-<a name="l01080"></a>01080 <a class="code" href="svn__auth_8h.html#ad0ada33b2e6776dc056ab70a15299c02" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_kwallet_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l01081"></a>01081                                      apr_pool_t *pool);
-<a name="l01082"></a>01082 
-<a name="l01083"></a>01083 <span class="comment"></span>
-<a name="l01084"></a>01084 <span class="comment">/**</span>
-<a name="l01085"></a>01085 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l01086"></a>01086 <span class="comment"> * svn_auth_cred_ssl_client_cert_pw_t that gets/sets information from the</span>
-<a name="l01087"></a>01087 <span class="comment"> * user&#39;s ~/.subversion configuration directory.  Allocate @a *provider in</span>
-<a name="l01088"></a>01088 <span class="comment"> * @a pool.</span>
-<a name="l01089"></a>01089 <span class="comment"> *</span>
-<a name="l01090"></a>01090 <span class="comment"> * This is like svn_client_get_ssl_client_cert_pw_file_provider(), except</span>
-<a name="l01091"></a>01091 <span class="comment"> * that the password is stored in KWallet.</span>
-<a name="l01092"></a>01092 <span class="comment"> *</span>
-<a name="l01093"></a>01093 <span class="comment"> * @since New in 1.6</span>
-<a name="l01094"></a>01094 <span class="comment"> * @note This function actually works only on systems with libsvn_auth_kwallet</span>
-<a name="l01095"></a>01095 <span class="comment"> * and KWallet installed.</span>
-<a name="l01096"></a>01096 <span class="comment"> */</span>
-<a name="l01097"></a>01097 <span class="keywordtype">void</span>
-<a name="l01098"></a>01098 <a class="code" href="svn__auth_8h.html#a4cfb9708bb9ee684f494d2fdf027a877" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_client_cert_pw_t that gets/sets...">svn_auth_get_kwallet_ssl_client_cert_pw_provider</a>(
-<a name="l01099"></a>01099   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
-<a name="l01100"></a>01100   apr_pool_t *pool);
-<a name="l01101"></a>01101 <span class="preprocessor">#endif </span><span class="comment">/* (!DARWIN &amp;&amp; !WIN32) || DOXYGEN */</span>
-<a name="l01102"></a>01102 
-<a name="l01103"></a>01103 <span class="preprocessor">#if !defined(WIN32) || defined(DOXYGEN)</span>
-<a name="l01104"></a>01104 <span class="preprocessor"></span><span class="comment">/**</span>
-<a name="l01105"></a>01105 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
-<a name="l01106"></a>01106 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
-<a name="l01107"></a>01107 <span class="comment"> * ~/.subversion configuration directory.</span>
-<a name="l01108"></a>01108 <span class="comment"> *</span>
-<a name="l01109"></a>01109 <span class="comment"> * This is like svn_client_get_simple_provider(), except that the</span>
-<a name="l01110"></a>01110 <span class="comment"> * password is obtained from gpg_agent, which will keep it in</span>
-<a name="l01111"></a>01111 <span class="comment"> * a memory cache.</span>
-<a name="l01112"></a>01112 <span class="comment"> *</span>
-<a name="l01113"></a>01113 <span class="comment"> * Allocate @a *provider in @a pool.</span>
+<a name="l00875"></a>00875 <span class="comment"> * This is like svn_auth_get_simple_provider(), except that, when</span>
+<a name="l00876"></a>00876 <span class="comment"> * running on Window 2000 or newer (or any other Windows version that</span>
+<a name="l00877"></a>00877 <span class="comment"> * includes the CryptoAPI), the provider encrypts the password before</span>
+<a name="l00878"></a>00878 <span class="comment"> * storing it to disk. On earlier versions of Windows, the provider</span>
+<a name="l00879"></a>00879 <span class="comment"> * does nothing.</span>
+<a name="l00880"></a>00880 <span class="comment"> *</span>
+<a name="l00881"></a>00881 <span class="comment"> * @since New in 1.4.</span>
+<a name="l00882"></a>00882 <span class="comment"> * @note This function is only available on Windows.</span>
+<a name="l00883"></a>00883 <span class="comment"> *</span>
+<a name="l00884"></a>00884 <span class="comment"> * @note An administrative password reset may invalidate the account&#39;s</span>
+<a name="l00885"></a>00885 <span class="comment"> * secret key. This function will detect that situation and behave as</span>
+<a name="l00886"></a>00886 <span class="comment"> * if the password were not cached at all.</span>
+<a name="l00887"></a>00887 <span class="comment"> */</span>
+<a name="l00888"></a>00888 <span class="keywordtype">void</span>
+<a name="l00889"></a>00889 <a class="code" href="svn__auth_8h.html#a150ee5110b383bcdb2ce9b341dc26798" title="Set *provider to an authentication provider of type svn_auth_cred_simple_t that gets/sets information...">svn_auth_get_windows_simple_provider</a>(<a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00890"></a>00890                                      apr_pool_t *pool);
+<a name="l00891"></a>00891 <span class="comment"></span>
+<a name="l00892"></a>00892 <span class="comment">/**</span>
+<a name="l00893"></a>00893 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
+<a name="l00894"></a>00894 <span class="comment"> * svn_auth_cred_ssl_client_cert_pw_t that gets/sets information from the</span>
+<a name="l00895"></a>00895 <span class="comment"> * user&#39;s ~/.subversion configuration directory.  Allocate @a *provider in</span>
+<a name="l00896"></a>00896 <span class="comment"> * @a pool.</span>
+<a name="l00897"></a>00897 <span class="comment"> *</span>
+<a name="l00898"></a>00898 <span class="comment"> * This is like svn_auth_get_ssl_client_cert_pw_file_provider(), except that</span>
+<a name="l00899"></a>00899 <span class="comment"> * when running on Window 2000 or newer, the provider encrypts the password</span>
+<a name="l00900"></a>00900 <span class="comment"> * before storing it to disk. On earlier versions of Windows, the provider</span>
+<a name="l00901"></a>00901 <span class="comment"> * does nothing.</span>
+<a name="l00902"></a>00902 <span class="comment"> *</span>
+<a name="l00903"></a>00903 <span class="comment"> * @since New in 1.6</span>
+<a name="l00904"></a>00904 <span class="comment"> * @note This function is only available on Windows.</span>
+<a name="l00905"></a>00905 <span class="comment"> *</span>
+<a name="l00906"></a>00906 <span class="comment"> * @note An administrative password reset may invalidate the account&#39;s</span>
+<a name="l00907"></a>00907 <span class="comment"> * secret key. This function will detect that situation and behave as</span>
+<a name="l00908"></a>00908 <span class="comment"> * if the password were not cached at all.</span>
+<a name="l00909"></a>00909 <span class="comment"> */</span>
+<a name="l00910"></a>00910 <span class="keywordtype">void</span>
+<a name="l00911"></a>00911 <a class="code" href="svn__auth_8h.html#a727c53b91e8d6b2d1d140b38e19f4d60" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_client_cert_pw_t that gets/sets...">svn_auth_get_windows_ssl_client_cert_pw_provider</a>(
+<a name="l00912"></a>00912   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00913"></a>00913   apr_pool_t *pool);
+<a name="l00914"></a>00914 <span class="comment"></span>
+<a name="l00915"></a>00915 <span class="comment">/**</span>
+<a name="l00916"></a>00916 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
+<a name="l00917"></a>00917 <span class="comment"> * svn_auth_cred_ssl_server_trust_t, allocated in @a pool.</span>
+<a name="l00918"></a>00918 <span class="comment"> *</span>
+<a name="l00919"></a>00919 <span class="comment"> * This provider automatically validates ssl server certificates with</span>
+<a name="l00920"></a>00920 <span class="comment"> * the CryptoApi, like Internet Explorer and the Windows network API do.</span>
+<a name="l00921"></a>00921 <span class="comment"> * This allows the rollout of root certificates via Windows Domain</span>
+<a name="l00922"></a>00922 <span class="comment"> * policies, instead of Subversion specific configuration.</span>
+<a name="l00923"></a>00923 <span class="comment"> *</span>
+<a name="l00924"></a>00924 <span class="comment"> * @since New in 1.5.</span>
+<a name="l00925"></a>00925 <span class="comment"> * @note This function is only available on Windows.</span>
+<a name="l00926"></a>00926 <span class="comment"> */</span>
+<a name="l00927"></a>00927 <span class="keywordtype">void</span>
+<a name="l00928"></a>00928 <a class="code" href="svn__auth_8h.html#aba0697d924aebb6d00a7a0fa40965161" title="Set *provider to an authentication provider of type svn_auth_cred_ssl_server_trust_t, allocated in pool.">svn_auth_get_windows_ssl_server_trust_provider</a>(
+<a name="l00929"></a>00929   <a class="code" href="structsvn__auth__provider__object__t.html" title="A provider object, ready to be put into an array and given to svn_auth_open().">svn_auth_provider_object_t</a> **provider,
+<a name="l00930"></a>00930   apr_pool_t *pool);
+<a name="l00931"></a>00931 
+<a name="l00932"></a>00932 <span class="preprocessor">#endif </span><span class="comment">/* WIN32 &amp;&amp; !__MINGW32__ || DOXYGEN */</span>
+<a name="l00933"></a>00933 
+<a name="l00934"></a>00934 <span class="preprocessor">#if defined(DARWIN) || defined(DOXYGEN)</span>
+<a name="l00935"></a>00935 <span class="preprocessor"></span><span class="comment">/**</span>
+<a name="l00936"></a>00936 <span class="comment"> * Set @a *provider to an authentication provider of type @c</span>
+<a name="l00937"></a>00937 <span class="comment"> * svn_auth_cred_simple_t that gets/sets information from the user&#39;s</span>
+<a name="l00938"></a>00938 <span class="comment"> * ~/.subversion configuration directory.  Allocate @a *provider in</span>
+<a name="l00939"></a>00939 <span class="comment"> * @a pool.</span>
+<a name="l00940"></a>00940 <span class="comment"> *</span>
+<a name="l00941"></a>00941 <span class="comment"> * This is like svn_auth_get_simple_provider(), except that the</span>
+<a name="l00942"></a>00942 <span class="comment"> * password is stored in the Mac OS KeyChain.</span>
+<a name="l00943"></a>00943 <span class="comment"> *</span>

[... 510 lines stripped ...]


Mime
View raw message