docs: clarify config-only options are stored for applications use

Signed-off-by: Sudharshan Hegde <sudharshanhegde68@gmail.com>
Reviewed-by: Jakub Jelen <jjelen@redhat.com>
Merge-Request: <https://gitlab.com/libssh/libssh-mirror/-/merge_requests/835>
This commit is contained in:
Sudharshan Hegde
2026-06-02 19:37:45 +05:30
committed by Jakub Jelen
parent aa3b91a194
commit f1e539829f

View File

@@ -727,6 +727,14 @@ int ssh_options_set_algo(ssh_session session,
* - SSH_ADDRESS_FAMILY_INET: IPv4 only
* - SSH_ADDRESS_FAMILY_INET6: IPv6 only
*
* - SSH_OPTIONS_PREFERRED_AUTHENTICATIONS
* Set the preferred authentication method(s) to use.
* This value is parsed from the configuration file and stored
* for the calling application to read; libssh does not
* automatically reorder authentication methods based on this
* setting.
* (string)
*
* - SSH_OPTIONS_BATCH_MODE
* If set to true, indicates that the application is running
* non-interactively and must not prompt the user. The
@@ -736,6 +744,9 @@ int ssh_options_set_algo(ssh_session session,
* of prompting the user. Use ssh_options_get_int() with
* SSH_OPTIONS_BATCH_MODE to read back this value after
* parsing a configuration file.
* Note that this value is parsed from the configuration file
* and stored for the calling application to read; libssh does
* not automatically change its behavior based on this setting.
* (bool)
*
* - SSH_OPTIONS_NUMBER_OF_PASSWORD_PROMPTS
@@ -744,6 +755,9 @@ int ssh_options_set_algo(ssh_session session,
* (>= 1). Passing NULL or a value <= 0 is rejected.
* When read via ssh_options_get_int(), 0 means "not configured"
* and the CLI will use the default of 3.
* Note that this value is parsed from the configuration file
* and stored for the calling application to read; libssh does
* not automatically limit password prompts based on this setting.
* (int)
*
* - SSH_OPTIONS_REQUEST_TTY
@@ -752,7 +766,7 @@ int ssh_options_set_algo(ssh_session session,
* SSH_REQUEST_TTY_YES (always),
* SSH_REQUEST_TTY_AUTO (request on login),
* and SSH_REQUEST_TTY_FORCE (always, even when a command is
* specified).Note that this value is parsed from the
* specified). Note that this value is parsed from the
* configuration file and stored for the calling application to
* read; libssh does not automatically request a PTY based on
* this setting.