mirror of
https://github.com/libssh2/libssh2.git
synced 2025-10-24 14:53:03 +03:00
b889b39945
To render in Git webviews as-is, to make it easier to edit, verify,
and to sync up with curl.
- add options to not build the `.3` man pages:
- autotools: `--disable-docs`
- cmake: `LIBSSH2_BUILD_DOCS=OFF`
- building `.3` man pages requires Perl after this patch.
- drop `mansyntax` and the shell / `grep` / GNU `man` tool requirements with it.
- scripts and most logic were copied from curl.
- add `cd2nroff` from curl, with edits to relax curl-specific checks.
- used `nroff2cd` (from curl) to convert from `.3` to `.md`. Then
manually fixed copyrights, inline function references and a couple
of other things.
Credits-to: Daniel Stenberg
Ref: eefcc1bda4
Ref: https://github.com/curl/curl/pull/12730
Ref: https://github.com/libssh2/www/issues/25#issuecomment-3289431671
Closes #1660
98 lines
2.7 KiB
Markdown
98 lines
2.7 KiB
Markdown
---
|
|
c: Copyright (C) The libssh2 project and its contributors.
|
|
SPDX-License-Identifier: BSD-3-Clause
|
|
Title: libssh2_session_supported_algs
|
|
Section: 3
|
|
Source: libssh2
|
|
See-also:
|
|
- libssh2_free(3)
|
|
- libssh2_session_method_pref(3)
|
|
- libssh2_session_methods(3)
|
|
---
|
|
|
|
# NAME
|
|
|
|
libssh2_session_supported_algs - get list of supported algorithms
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <libssh2.h>
|
|
|
|
int
|
|
libssh2_session_supported_algs(LIBSSH2_SESSION* session,
|
|
int method_type,
|
|
const char*** algs);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
*session* - An instance of initialized LIBSSH2_SESSION (the function will
|
|
use its pointer to the memory allocation function). *method_type* -
|
|
Method type. See *libssh2_session_method_pref(3)*. *algs* - Address
|
|
of a pointer that will point to an array of returned algorithms
|
|
|
|
Get a list of supported algorithms for the given *method_type*. The
|
|
method_type parameter is equivalent to method_type in
|
|
*libssh2_session_method_pref(3)*. If successful, the function will
|
|
allocate the appropriate amount of memory. When not needed anymore, it must be
|
|
deallocated by calling *libssh2_free(3)*. When this function is
|
|
unsuccessful, this must not be done.
|
|
|
|
In order to get a list of all supported compression algorithms,
|
|
libssh2_session_flag(session, LIBSSH2_FLAG_COMPRESS, 1) must be called before
|
|
calling this function, otherwise only "none" will be returned.
|
|
|
|
If successful, the function will allocate and fill the array with supported
|
|
algorithms (the same names as defined in RFC 4253). The array is not NULL
|
|
terminated.
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
#include "libssh2.h"
|
|
|
|
const char **algorithms;
|
|
int rc, i;
|
|
LIBSSH2_SESSION *session;
|
|
|
|
/* initialize session */
|
|
session = libssh2_session_init();
|
|
rc = libssh2_session_supported_algs(session,
|
|
LIBSSH2_METHOD_CRYPT_CS,
|
|
&algorithms);
|
|
if(rc > 0) {
|
|
/* the call succeeded, do sth. with the list of algorithms
|
|
(e.g. list them)... */
|
|
printf("Supported symmetric algorithms:\n");
|
|
for(i = 0; i < rc; i++)
|
|
printf("\t%s\n", algorithms[i]);
|
|
|
|
/* ... and free the allocated memory when not needed anymore */
|
|
libssh2_free(session, algorithms);
|
|
}
|
|
else {
|
|
/* call failed, error handling */
|
|
}
|
|
~~~
|
|
|
|
# RETURN VALUE
|
|
|
|
On success, a number of returned algorithms (i.e a positive number will be
|
|
returned). In case of a failure, an error code (a negative number, see below)
|
|
is returned. 0 should never be returned.
|
|
|
|
# ERRORS
|
|
|
|
*LIBSSH2_ERROR_BAD_USE* - Invalid address of algs.
|
|
|
|
*LIBSSH2_ERROR_METHOD_NOT_SUPPORTED* - Unknown method type.
|
|
|
|
*LIBSSH2_ERROR_INVAL* - Internal error (normally should not occur).
|
|
|
|
*LIBSSH2_ERROR_ALLOC* - Allocation of memory failed.
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 1.4.0
|