1
0
mirror of https://github.com/libssh2/libssh2.git synced 2025-07-29 13:01:14 +03:00

tidy-up: text nits, English contractions [ci skip]

In input/output text and docs mostly.
This commit is contained in:
Viktor Szakats
2023-04-27 14:17:52 +00:00
parent f4a4c05dc3
commit d67aaaffc4
73 changed files with 99 additions and 99 deletions

View File

@ -118,7 +118,7 @@ set(LIB_SHARED "libssh2_shared") # Must match libssh2_shared_EXPORTS macro in i
# Symbol hiding # Symbol hiding
option(HIDE_SYMBOLS "Set to ON to hide all libssh2 symbols that aren't officially external" ON) option(HIDE_SYMBOLS "Set to ON to hide all libssh2 symbols that are not officially external" ON)
mark_as_advanced(HIDE_SYMBOLS) mark_as_advanced(HIDE_SYMBOLS)
if(HIDE_SYMBOLS) if(HIDE_SYMBOLS)
set(LIB_SHARED_DEFINITIONS LIBSSH2_EXPORTS) set(LIB_SHARED_DEFINITIONS LIBSSH2_EXPORTS)
@ -168,7 +168,7 @@ else()
endif() endif()
check_symbol_exists(strtoll stdlib.h HAVE_STRTOLL) check_symbol_exists(strtoll stdlib.h HAVE_STRTOLL)
if(NOT HAVE_STRTOLL) if(NOT HAVE_STRTOLL)
# Try _strtoi64 if strtoll isn't available # Try _strtoi64() if strtoll() is not available
check_symbol_exists(_strtoi64 stdlib.h HAVE_STRTOI64) check_symbol_exists(_strtoi64 stdlib.h HAVE_STRTOI64)
endif() endif()
check_symbol_exists(snprintf stdio.h HAVE_SNPRINTF) check_symbol_exists(snprintf stdio.h HAVE_SNPRINTF)
@ -190,7 +190,7 @@ if(${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" OR
# have been in a bad mood, because poll() only works on the /proc # have been in a bad mood, because poll() only works on the /proc
# filesystem here" # filesystem here"
# #
# Mac OS X's poll has funny behaviors, like: # macOS poll() has funny behaviors, like:
# not being able to do poll on no filedescriptors (10.3?) # not being able to do poll on no filedescriptors (10.3?)
# not being able to poll on some files (like anything in /dev) # not being able to poll on some files (like anything in /dev)
# not having reliable timeout support # not having reliable timeout support

View File

@ -123,7 +123,7 @@ AC_DEFUN([CURL_CHECK_COMPILER_CLANG], [
clangver=`echo $fullclangver | grep "based on LLVM " | "$SED" 's/.*(based on LLVM \(@<:@0-9@:>@*\.@<:@0-9@:>@*\).*)/\1/'` clangver=`echo $fullclangver | grep "based on LLVM " | "$SED" 's/.*(based on LLVM \(@<:@0-9@:>@*\.@<:@0-9@:>@*\).*)/\1/'`
if test -z "$clangver"; then if test -z "$clangver"; then
if echo $fullclangver | grep "Apple LLVM version " >/dev/null; then if echo $fullclangver | grep "Apple LLVM version " >/dev/null; then
dnl Starting with XCode 7 / clang 3.7, Apple clang won't tell its upstream version dnl Starting with Xcode 7 / clang 3.7, Apple clang won't tell its upstream version
clangver="3.7" clangver="3.7"
else else
clangver=`echo $fullclangver | "$SED" 's/.*version \(@<:@0-9@:>@*\.@<:@0-9@:>@*\).*/\1/'` clangver=`echo $fullclangver | "$SED" 's/.*version \(@<:@0-9@:>@*\.@<:@0-9@:>@*\).*/\1/'`

View File

@ -303,7 +303,7 @@ case $host in
dnl Interix: "does provide poll(), but the implementing developer must dnl Interix: "does provide poll(), but the implementing developer must
dnl have been in a bad mood, because poll() only works on the /proc dnl have been in a bad mood, because poll() only works on the /proc
dnl filesystem here" dnl filesystem here"
dnl Mac OS X's poll has funny behaviors, like: dnl macOS poll() has funny behaviors, like:
dnl not being able to do poll on no fildescriptors (10.3?) dnl not being able to do poll on no fildescriptors (10.3?)
dnl not being able to poll on some files (like anything in /dev) dnl not being able to poll on some files (like anything in /dev)
dnl not having reliable timeout support dnl not having reliable timeout support

View File

@ -1,5 +1,5 @@
libssh2 is the result of many friendly people. This list is an attempt to libssh2 is the result of many friendly people. This list is an attempt to
mention all contributors. If we've missed anyone, tell us! mention all contributors. If we have missed anyone, tell us!
This list of names is a-z sorted. This list of names is a-z sorted.

View File

@ -58,7 +58,7 @@ Terminates the crypto library use. May be an empty macro if not needed.
1.1) Crypto runtime detection 1.1) Crypto runtime detection
The libssh2_crypto_engine_t enum must include the new engine, and The libssh2_crypto_engine_t enum must include the new engine, and
libssh2_crypto_engine() must return it when it's built in. libssh2_crypto_engine() must return it when it is built in.
2) HMAC 2) HMAC

View File

@ -46,7 +46,7 @@ cache files.)
to figure out how `configure' could check whether to do them, and mail to figure out how `configure' could check whether to do them, and mail
diffs or instructions to the address given in the `README' so they can diffs or instructions to the address given in the `README' so they can
be considered for the next release. If you are using the cache, and at be considered for the next release. If you are using the cache, and at
some point `config.cache' contains results you don't want to keep, you some point `config.cache' contains results you do not want to keep, you
may remove or edit it. may remove or edit it.
The file `configure.ac' (or `configure.in') is used to create The file `configure.ac' (or `configure.in') is used to create
@ -57,7 +57,7 @@ a newer version of `autoconf'.
The simplest way to compile this package is: The simplest way to compile this package is:
1. `cd' to the directory containing the package's source code and type 1. `cd' to the directory containing the package's source code and type
`./configure' to configure the package for your system. If you're `./configure' to configure the package for your system. If you are
using `csh' on an old version of System V, you might need to type using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute `sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself. `configure' itself.
@ -148,7 +148,7 @@ is something like `gnu-as' or `x' (for the X Window System). The
package recognizes. package recognizes.
For packages that use the X Window System, `configure' can usually For packages that use the X Window System, `configure' can usually
find the X include and library files automatically, but if it doesn't, find the X include and library files automatically, but if it does not,
you can use the `configure' options `--x-includes=DIR' and you can use the `configure' options `--x-includes=DIR' and
`--x-libraries=DIR' to specify their locations. `--x-libraries=DIR' to specify their locations.
@ -170,7 +170,7 @@ where SYSTEM can have one of these forms:
OS KERNEL-OS OS KERNEL-OS
See the file `config.sub' for the possible values of each field. If See the file `config.sub' for the possible values of each field. If
`config.sub' isn't included in this package, then this package doesn't `config.sub' is not included in this package, then this package does not
need to know the machine type. need to know the machine type.
If you are _building_ compiler tools for cross-compiling, you should If you are _building_ compiler tools for cross-compiling, you should

View File

@ -107,7 +107,7 @@ or
cmake --build . --target RUN_TESTS cmake --build . --target RUN_TESTS
``` ```
How do I use libssh2 in my project if my project doesn't use CMake? How do I use libssh2 in my project if my project does not use CMake?
------------------------------------------------------------------- -------------------------------------------------------------------
If you are not using CMake for your own project, install libssh2 If you are not using CMake for your own project, install libssh2
@ -122,14 +122,14 @@ or
``` ```
and then specify the install location to your project in the normal and then specify the install location to your project in the normal
way for your build environment. If you don't like the default install way for your build environment. If you do not like the default install
location, add `-DCMAKE_INSTALL_PREFIX=<chosen prefix>` when initially location, add `-DCMAKE_INSTALL_PREFIX=<chosen prefix>` when initially
configuring the project. configuring the project.
How can I use libssh2 in my project if it also uses CMake? How can I use libssh2 in my project if it also uses CMake?
---------------------------------------------------------- ----------------------------------------------------------
If your own project also uses CMake, you don't need to worry about If your own project also uses CMake, you do not need to worry about
setting it up with libssh2's location. Just add just the following setting it up with libssh2's location. Just add just the following
lines and CMake will find libssh2 on your system, set up the necessary lines and CMake will find libssh2 on your system, set up the necessary
paths and link the library with your binary. paths and link the library with your binary.
@ -139,7 +139,7 @@ paths and link the library with your binary.
Of course, you still have to make libssh2 available on your system Of course, you still have to make libssh2 available on your system
first. You can install it in the traditional way shown above, but you first. You can install it in the traditional way shown above, but you
don't have to. Instead you can just build it, which will export its do not have to. Instead you can just build it, which will export its
location to the user package registry [3] where `find_package` will location to the user package registry [3] where `find_package` will
find it. find it.

View File

@ -28,8 +28,8 @@ reference to the security nature of the commit if done prior to the public
announcement. announcement.
- The person discovering the issue, the reporter, reports the vulnerability - The person discovering the issue, the reporter, reports the vulnerability
privately to `libssh2-security@haxx.se`. That's an email alias that reaches a privately to `libssh2-security@haxx.se`. That is an email alias that reaches
handful of selected and trusted people. a handful of selected and trusted people.
- Messages that do not relate to the reporting or managing of an undisclosed - Messages that do not relate to the reporting or managing of an undisclosed
security vulnerability in libssh2 are ignored and no further action is security vulnerability in libssh2 are ignored and no further action is
@ -64,7 +64,7 @@ announcement.
[distros@openwall](https://oss-security.openwall.org/wiki/mailing-lists/distros) [distros@openwall](https://oss-security.openwall.org/wiki/mailing-lists/distros)
when also informing and preparing them for the upcoming public security when also informing and preparing them for the upcoming public security
vulnerability announcement - attach the advisory draft for information. Note vulnerability announcement - attach the advisory draft for information. Note
that 'distros' won't accept an embargo longer than 14 days. that 'distros' will not accept an embargo longer than 14 days.
- Update the "security advisory" with the CVE number. - Update the "security advisory" with the CVE number.
@ -90,10 +90,10 @@ LIBSSH2-SECURITY (at haxx dot se)
-------------------------------- --------------------------------
Who is on this list? There are a couple of criteria you must meet, and then we Who is on this list? There are a couple of criteria you must meet, and then we
might ask you to join the list or you can ask to join it. It really isn't very might ask you to join the list or you can ask to join it. It really is not very
formal. We basically only require that you have a long-term presence in the formal. We basically only require that you have a long-term presence in the
libssh2 project and you have shown an understanding for the project and its way libssh2 project and you have shown an understanding for the project and its way
of working. You must've been around for a good while and you should have no of working. You must have been around for a good while and you should have no
plans in vanishing in the near future. plans in vanishing in the near future.
We do not make the list of participants public mostly because it tends to vary We do not make the list of participants public mostly because it tends to vary

View File

@ -5,13 +5,13 @@ Things TODO
Improvements" below for details Improvements" below for details
* make sure the windowing code adapts better to slow situations so that it * make sure the windowing code adapts better to slow situations so that it
doesn't then use as much memory as today. Possibly by an app-controllable does not then use as much memory as today. Possibly by an app-controllable
"Window mode"? "Window mode"?
* Decrease the number of mallocs. Everywhere. Will get easier once the * Decrease the number of mallocs. Everywhere. Will get easier once the
buffering improvements have been done. buffering improvements have been done.
* Use SO_NOSIGPIPE for Mac OS/BSD systems where MSG_NOSIGNAL doesn't * Use SO_NOSIGPIPE for Mac OS/BSD systems where MSG_NOSIGNAL does not
exist/work exist/work
* Extend the test suite to actually test lots of aspects of libssh2 * Extend the test suite to actually test lots of aspects of libssh2
@ -119,7 +119,7 @@ I suggest we introduce two new helper functions:
short return, nothing more should be attempted to get sent until select() short return, nothing more should be attempted to get sent until select()
(or equivalent) has been used on the master socket again. (or equivalent) has been used on the master socket again.
I haven't yet figured out a sensible API for how these functions should return I have not yet figured out a sensible API for how these functions should return
that info, but if we agree on the general principles I guess we can work that that info, but if we agree on the general principles I guess we can work that
out. out.

View File

@ -15,7 +15,7 @@ libssh2_agent_connect(LIBSSH2_AGENT *agent);
Connect to an ssh-agent running on the system. Connect to an ssh-agent running on the system.
Call \fBlibssh2_agent_disconnect(3)\fP to close the connection after Call \fBlibssh2_agent_disconnect(3)\fP to close the connection after
you're doing using it. you are doing using it.
.SH RETURN VALUE .SH RETURN VALUE
Returns 0 if succeeded, or a negative value for error. Returns 0 if succeeded, or a negative value for error.
.SH AVAILABILITY .SH AVAILABILITY

View File

@ -17,7 +17,7 @@ representation of an ssh-agent connection. After the successful
initialization, an application can call \fBlibssh2_agent_connect(3)\fP initialization, an application can call \fBlibssh2_agent_connect(3)\fP
to connect to a running ssh-agent. to connect to a running ssh-agent.
Call \fBlibssh2_agent_free(3)\fP to free the handle again after you're Call \fBlibssh2_agent_free(3)\fP to free the handle again after you are
doing using it. doing using it.
.SH RETURN VALUE .SH RETURN VALUE
Returns a handle pointer or NULL if something went wrong. The returned handle Returns a handle pointer or NULL if something went wrong. The returned handle

View File

@ -24,7 +24,7 @@ started with
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH AVAILABILITY .SH AVAILABILITY
Marked as deprecated since 1.4.0 Marked as deprecated since 1.4.0
.SH ERRORS .SH ERRORS

View File

@ -12,7 +12,7 @@ libssh2_base64_decode(LIBSSH2_SESSION *session, char **dest,
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
This function is deemed DEPRECATED and will be removed from libssh2 in a This function is deemed DEPRECATED and will be removed from libssh2 in a
future version. Don't use it! future version. Do not use it!
Decode a base64 chunk and store it into a newly allocated buffer. 'dest_len' Decode a base64 chunk and store it into a newly allocated buffer. 'dest_len'
will be set to hold the length of the returned buffer that '*dest' will point will be set to hold the length of the returned buffer that '*dest' will point
@ -22,7 +22,7 @@ The returned buffer is allocated by this function, but it is not clear how to
free that memory! free that memory!
.SH BUGS .SH BUGS
The memory that *dest points to is allocated by the malloc function libssh2 The memory that *dest points to is allocated by the malloc function libssh2
uses, but there's no way for an application to free this data in a safe and uses, but there is no way for an application to free this data in a safe and
reliable way! reliable way!
.SH RETURN VALUE .SH RETURN VALUE
0 if successful, \-1 if any error occurred. 0 if successful, \-1 if any error occurred.

View File

@ -20,7 +20,7 @@ connection as well, follow this command with
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_SOCKET_SEND\fP - Unable to send data on socket. \fILIBSSH2_ERROR_SOCKET_SEND\fP - Unable to send data on socket.
.SH SEE ALSO .SH SEE ALSO

View File

@ -29,4 +29,4 @@ be flushed by number or using one of the provided macros.
.SH RETURN VALUE .SH RETURN VALUE
Return the number of bytes flushed or negative on failure. Return the number of bytes flushed or negative on failure.
It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.

View File

@ -16,7 +16,7 @@ Instruct the remote host to stop listening for new connections on a previously r
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -19,6 +19,6 @@ can safely free its own resources.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_channel_close(3) .BR libssh2_channel_close(3)

View File

@ -29,7 +29,7 @@ Initiate a request on a session type channel such as returned by
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -36,7 +36,7 @@ macros.
.SH RETURN VALUE .SH RETURN VALUE
Actual number of bytes read or negative on failure. It returns Actual number of bytes read or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
Note that a return value of zero (0) can in fact be a legitimate value and Note that a return value of zero (0) can in fact be a legitimate value and
only signals that no payload data was read. It is not an error. only signals that no payload data was read. It is not an error.

View File

@ -19,4 +19,4 @@ for the duration of the SSH session.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.

View File

@ -41,7 +41,7 @@ success.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -14,7 +14,7 @@ channel. Processes typically interpret this as a closed stdin descriptor.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_SOCKET_SEND\fP - Unable to send data on socket. \fILIBSSH2_ERROR_SOCKET_SEND\fP - Unable to send data on socket.
.SH SEE ALSO .SH SEE ALSO

View File

@ -33,7 +33,7 @@ server despite returning success.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -16,7 +16,7 @@ examine the exit status.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN Return 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN
when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative
number, it isn't really a failure per se. number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_channel_send_eof(3) .BR libssh2_channel_send_eof(3)
.BR libssh2_channel_eof(3) .BR libssh2_channel_eof(3)

View File

@ -14,7 +14,7 @@ Wait for the remote end to send EOF.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_channel_send_eof(3) .BR libssh2_channel_send_eof(3)
.BR libssh2_channel_eof(3) .BR libssh2_channel_eof(3)

View File

@ -34,7 +34,7 @@ least 32K of data to this function.
.SH RETURN VALUE .SH RETURN VALUE
Actual number of bytes written or negative on failure. Actual number of bytes written or negative on failure.
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -33,7 +33,7 @@ invoked when the remote host accepts the X11 forwarding.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -9,7 +9,7 @@ void
libssh2_exit(void); libssh2_exit(void);
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
Exit the libssh2 functions and free's all memory used internal. Exit the libssh2 functions and frees all memory used internal.
.SH AVAILABILITY .SH AVAILABILITY
Added in libssh2 1.2.5 Added in libssh2 1.2.5
.SH SEE ALSO .SH SEE ALSO

View File

@ -53,7 +53,7 @@ LIBSSH2_KNOWNHOST_KEY_RSA1, LIBSSH2_KNOWNHOST_KEY_SSHRSA or
LIBSSH2_KNOWNHOST_KEY_SSHDSS. LIBSSH2_KNOWNHOST_KEY_SSHDSS.
\fIstore\fP should point to a pointer that gets filled in to point to the \fIstore\fP should point to a pointer that gets filled in to point to the
known host data after the addition. NULL can be passed if you don't care about known host data after the addition. NULL can be passed if you do not care about
this pointer. this pointer.
.SH RETURN VALUE .SH RETURN VALUE
Returns a regular libssh2 error code, where negative values are error codes Returns a regular libssh2 error code, where negative values are error codes

View File

@ -58,7 +58,7 @@ LIBSSH2_KNOWNHOST_KEY_RSA1, LIBSSH2_KNOWNHOST_KEY_SSHRSA or
LIBSSH2_KNOWNHOST_KEY_SSHDSS. LIBSSH2_KNOWNHOST_KEY_SSHDSS.
\fIstore\fP should point to a pointer that gets filled in to point to the \fIstore\fP should point to a pointer that gets filled in to point to the
known host data after the addition. NULL can be passed if you don't care about known host data after the addition. NULL can be passed if you do not care about
this pointer. this pointer.
.SH RETURN VALUE .SH RETURN VALUE
Returns a regular libssh2 error code, where negative values are error codes Returns a regular libssh2 error code, where negative values are error codes

View File

@ -50,7 +50,7 @@ LIBSSH2_KNOWNHOST_CHECK_NOTFOUND - no host match was found
LIBSSH2_KNOWNHOST_CHECK_MATCH - hosts and keys match. LIBSSH2_KNOWNHOST_CHECK_MATCH - hosts and keys match.
LIBSSH2_KNOWNHOST_CHECK_MISMATCH - host was found, but the keys didn't match! LIBSSH2_KNOWNHOST_CHECK_MISMATCH - host was found, but the keys did not match!
.SH AVAILABILITY .SH AVAILABILITY
Added in libssh2 1.2 Added in libssh2 1.2
.SH EXAMPLE .SH EXAMPLE

View File

@ -55,7 +55,7 @@ LIBSSH2_KNOWNHOST_CHECK_NOTFOUND - no host match was found
LIBSSH2_KNOWNHOST_CHECK_MATCH - hosts and keys match. LIBSSH2_KNOWNHOST_CHECK_MATCH - hosts and keys match.
LIBSSH2_KNOWNHOST_CHECK_MISMATCH - host was found, but the keys didn't match! LIBSSH2_KNOWNHOST_CHECK_MISMATCH - host was found, but the keys did not match!
.SH AVAILABILITY .SH AVAILABILITY
Added in libssh2 1.2.6 Added in libssh2 1.2.6
.SH EXAMPLE .SH EXAMPLE

View File

@ -15,7 +15,7 @@ libssh2_knownhost_init(LIBSSH2_SESSION *session);
Init a collection of known hosts for this session. Returns the handle to an Init a collection of known hosts for this session. Returns the handle to an
internal representation of a known host collection. internal representation of a known host collection.
Call \fBlibssh2_knownhost_free(3)\fP to free the collection again after you're Call \fBlibssh2_knownhost_free(3)\fP to free the collection again after you are
doing using it. doing using it.
.SH RETURN VALUE .SH RETURN VALUE
Returns a handle pointer or NULL if something went wrong. The returned handle Returns a handle pointer or NULL if something went wrong. The returned handle

View File

@ -17,7 +17,7 @@ Return a pointer to where the abstract pointer provided to
de-referenced pointer, the internal storage of the session instance may be de-referenced pointer, the internal storage of the session instance may be
modified in place. modified in place.
.SH RETURN VALUE .SH RETURN VALUE
A pointer to session internal storage who's contents point to previously A pointer to session internal storage whose contents point to previously
provided abstract data. provided abstract data.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_session_init_ex(3) .BR libssh2_session_init_ex(3)

View File

@ -21,7 +21,7 @@ corresponding to the protocol and libssh2 version will be sent by default.
.SH RETURN VALUE .SH RETURN VALUE
Returns 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN Returns 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN
when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative
number, it isn't really a failure per se. number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.
.SH AVAILABILITY .SH AVAILABILITY

View File

@ -46,8 +46,8 @@ ssize_t sendcb(libssh2_socket_t sockfd, const void *buffer,
\fBsockfd\fP is the socket to write to, \fBbuffer\fP points to the data to \fBsockfd\fP is the socket to write to, \fBbuffer\fP points to the data to
send, \fBlength\fP is the size of the data, \fBflags\fP is the flags that send, \fBlength\fP is the size of the data, \fBflags\fP is the flags that
would've been used to a \fIsend()\fP call and \fBabstract\fP is a pointer to would have been used to a \fIsend()\fP call and \fBabstract\fP is a pointer
the abstract pointer set in the \fIlibssh2_session_init_ex(3)\fP call. to the abstract pointer set in the \fIlibssh2_session_init_ex(3)\fP call.
The callback returns the number of bytes sent, or -1 for error. The special The callback returns the number of bytes sent, or -1 for error. The special
return code \fB-EAGAIN\fP can be returned to signal that the send was aborted return code \fB-EAGAIN\fP can be returned to signal that the send was aborted
@ -65,7 +65,7 @@ ssize_t recvcb(libssh2_socket_t sockfd, void *buffer,
\fBsockfd\fP is the socket to read from, \fBbuffer\fP where to store received \fBsockfd\fP is the socket to read from, \fBbuffer\fP where to store received
data into, \fBlength\fP is the size of the buffer, \fBflags\fP is the flags data into, \fBlength\fP is the size of the buffer, \fBflags\fP is the flags
that would've been used to a \fIrecv()\fP call and \fBabstract\fP is a pointer that would have been used to a \fIrecv()\fP call and \fBabstract\fP is a pointer
to the abstract pointer set in the \fIlibssh2_session_init_ex(3)\fP call. to the abstract pointer set in the \fIlibssh2_session_init_ex(3)\fP call.
The callback returns the number of bytes read, or -1 for error. The special The callback returns the number of bytes read, or -1 for error. The special

View File

@ -36,6 +36,6 @@ and \fIlang\fP set to an empty string.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_session_init_ex(3) .BR libssh2_session_init_ex(3)

View File

@ -14,7 +14,7 @@ Frees all resources associated with a session instance. Typically called after
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_session_init_ex(3) .BR libssh2_session_init_ex(3)
.BR libssh2_session_disconnect_ex(3) .BR libssh2_session_disconnect_ex(3)

View File

@ -27,7 +27,7 @@ as they are used during the protocol initiation phase.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_INVAL\fP - The requested method type was invalid. \fILIBSSH2_ERROR_INVAL\fP - The requested method type was invalid.

View File

@ -26,7 +26,7 @@ are macros for \fBlibssh2_sftp_close_handle(3)\fP.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -85,7 +85,7 @@ Test for a socket
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -20,7 +20,7 @@ For this to work requires fsync@openssh.com support on the server.
.SH RETURN VALUE .SH RETURN VALUE
Returns 0 on success or negative on failure. If used in non-blocking mode, it Returns 0 on success or negative on failure. If used in non-blocking mode, it
returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -31,7 +31,7 @@ Create a directory on the remote file system.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. Return 0 on success or negative on failure.
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -29,7 +29,7 @@ to block.
.SH RETURN VALUE .SH RETURN VALUE
Number of bytes actually populated into buffer, or negative on failure. Number of bytes actually populated into buffer, or negative on failure.
It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -41,7 +41,7 @@ statbuf style data into.
.SH RETURN VALUE .SH RETURN VALUE
Number of bytes actually populated into buffer (not counting the terminating Number of bytes actually populated into buffer (not counting the terminating
zero), or negative on failure. It returns LIBSSH2_ERROR_EAGAIN when it would zero), or negative on failure. It returns LIBSSH2_ERROR_EAGAIN when it would
otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative number, it isn't otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative number, it is not
really a failure per se. really a failure per se.
.SH BUG .SH BUG
Passing in a too small buffer for 'buffer' or 'longentry' when receiving data Passing in a too small buffer for 'buffer' or 'longentry' when receiving data

View File

@ -46,7 +46,7 @@ and/or using native system calls when possible.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -23,7 +23,7 @@ remove.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -18,6 +18,6 @@ associated with it.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH SEE ALSO .SH SEE ALSO
.BR libssh2_sftp_init(3) .BR libssh2_sftp_init(3)

View File

@ -61,7 +61,7 @@ struct LIBSSH2_SFTP_ATTRIBUTES {
.SH RETURN VALUE .SH RETURN VALUE
Returns 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN Returns 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN
when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative
number, it isn't really a failure per se. number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -60,7 +60,7 @@ Set-user-ID/set-group-ID bits are ignored by \fBexec\fP(3).
.SH RETURN VALUE .SH RETURN VALUE
Returns 0 on success or negative on failure. If used in non-blocking mode, it Returns 0 on success or negative on failure. If used in non-blocking mode, it
returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -57,7 +57,7 @@ number of bytes it copied to the target buffer (not including the terminating
zero) or negative on failure. zero) or negative on failure.
It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
From 1.2.8, LIBSSH2_ERROR_BUFFER_TOO_SMALL is returned if the given 'target' From 1.2.8, LIBSSH2_ERROR_BUFFER_TOO_SMALL is returned if the given 'target'
buffer is too small to fit the requested object name. buffer is too small to fit the requested object name.

View File

@ -25,7 +25,7 @@ Unlink (delete) a file from the remote filesystem.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -33,15 +33,15 @@ create several smaller outgoing packets for all data you pass to this function
and it will return a positive number as soon as the first packet is and it will return a positive number as soon as the first packet is
acknowledged from the server. acknowledged from the server.
This has the effect that sometimes more data has been sent off but isn't acked This has the effect that sometimes more data has been sent off but is not acked
yet when this function returns, and when this function is subsequently called yet when this function returns, and when this function is subsequently called
again to write more data, libssh2 will immediately figure out that the data is again to write more data, libssh2 will immediately figure out that the data is
already received remotely. already received remotely.
In most normal situation this should not cause any problems, but it should be In most normal situation this should not cause any problems, but it should be
noted that if you've once called libssh2_sftp_write() with data and it returns noted that if you have once called libssh2_sftp_write() with data and it returns
short, you MUST still assume that the rest of the data might've been cached so short, you MUST still assume that the rest of the data might have been cached so
you need to make sure you don't alter that data and think that the version you you need to make sure you do not alter that data and think that the version you
have in your next function invoke will be detected or used. have in your next function invoke will be detected or used.
The reason for this funny behavior is that SFTP can only send 32K data in each The reason for this funny behavior is that SFTP can only send 32K data in each
@ -52,7 +52,7 @@ latency connections. And we want that.
Actual number of bytes written or negative on failure. Actual number of bytes written or negative on failure.
If used in non-blocking mode, it returns LIBSSH2_ERROR_EAGAIN when it would If used in non-blocking mode, it returns LIBSSH2_ERROR_EAGAIN when it would
otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative number, it isn't otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative number, it is not
really a failure per se. really a failure per se.
If this function returns 0 (zero) it should not be considered an error, but If this function returns 0 (zero) it should not be considered an error, but

View File

@ -47,7 +47,7 @@ may use keyboard-interactive authentication type too.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN Return 0 on success or negative on failure. It returns LIBSSH2_ERROR_EAGAIN
when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a negative
number, it isn't really a failure per se. number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -42,7 +42,7 @@ PAM or another authentication backed) instead.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
Some of the errors this function may return include: Some of the errors this function may return include:

View File

@ -34,7 +34,7 @@ on disk
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -17,7 +17,7 @@ libssh2_userauth_publickey_frommemory(LIBSSH2_SESSION *session,
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
This function allows to authenticate a session with a public key read from memory. This function allows to authenticate a session with a public key read from memory.
It's only supported when libssh2 is backed by OpenSSL. It is only supported when libssh2 is backed by OpenSSL.
\fIsession\fP - Session instance as returned by \fIsession\fP - Session instance as returned by
.BR libssh2_session_init_ex(3) .BR libssh2_session_init_ex(3)
@ -39,7 +39,7 @@ Attempt public key authentication using a PEM encoded private key file stored in
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
\fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed. \fILIBSSH2_ERROR_ALLOC\fP - An internal memory allocation call failed.

View File

@ -127,7 +127,7 @@ NULL.
.SH RETURN VALUE .SH RETURN VALUE
Return 0 on success or negative on failure. It returns Return 0 on success or negative on failure. It returns
LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN when it would otherwise block. While
LIBSSH2_ERROR_EAGAIN is a negative number, it isn't really a failure per se. LIBSSH2_ERROR_EAGAIN is a negative number, it is not really a failure per se.
.SH ERRORS .SH ERRORS
Some of the errors this function may return include: Some of the errors this function may return include:

View File

@ -19,7 +19,7 @@ bit number in the 0xMMmmpp format. MM for major, mm for minor and pp for patch
number. number.
.SH RETURN VALUE .SH RETURN VALUE
The version number of libssh2 is returned as a pointer to a zero terminated The version number of libssh2 is returned as a pointer to a zero terminated
string or NULL if the \fIrequired_version\fP isn't fulfilled. string or NULL if the \fIrequired_version\fP is not fulfilled.
.SH EXAMPLE .SH EXAMPLE
To make sure you run with the correct libssh2 version: To make sure you run with the correct libssh2 version:

View File

@ -84,7 +84,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -122,7 +122,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -167,7 +167,7 @@ int main(int argc, char *argv[])
tempstorage = fopen(storage, "wb"); tempstorage = fopen(storage, "wb");
if(!tempstorage) { if(!tempstorage) {
fprintf(stderr, "Can't open temp storage file %s\n", storage); fprintf(stderr, "Cannot open temp storage file %s\n", storage);
goto shutdown; goto shutdown;
} }
@ -271,8 +271,8 @@ int main(int argc, char *argv[])
tempstorage = fopen(storage, "rb"); tempstorage = fopen(storage, "rb");
if(!tempstorage) { if(!tempstorage) {
/* weird, we can't read the file we just wrote to... */ /* weird, we cannot read the file we just wrote to... */
fprintf(stderr, "can't open %s for reading\n", storage); fprintf(stderr, "Cannot open %s for reading\n", storage);
goto shutdown; goto shutdown;
} }

View File

@ -92,7 +92,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -91,7 +91,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -128,7 +128,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -128,7 +128,7 @@ int main(int argc, char *argv[])
local = fopen(loclfile, "rb"); local = fopen(loclfile, "rb");
if(!local) { if(!local) {
fprintf(stderr, "Can't open local file %s\n", loclfile); fprintf(stderr, "Cannot open local file %s\n", loclfile);
return 1; return 1;
} }

View File

@ -165,7 +165,7 @@ int main(int argc, char *argv[])
prev_identity = identity; prev_identity = identity;
} }
if(rc) { if(rc) {
fprintf(stderr, "Couldn't continue authentication\n"); fprintf(stderr, "Could not continue authentication\n");
goto shutdown; goto shutdown;
} }
} }

View File

@ -185,7 +185,7 @@ int main(int argc, char *argv[])
prev_identity = identity; prev_identity = identity;
} }
if(rc) { if(rc) {
fprintf(stderr, "Couldn't continue authentication\n"); fprintf(stderr, "Could not continue authentication\n");
goto shutdown; goto shutdown;
} }
@ -214,8 +214,8 @@ int main(int argc, char *argv[])
waitsocket(sock, session); waitsocket(sock, session);
} }
if(rc) { if(rc) {
fprintf(stderr, "Error, couldn't request auth agent, error code %d.\n", fprintf(stderr, "Error, could not request auth agent, "
rc); "error code %d.\n", rc);
exit(1); exit(1);
} }
else { else {

View File

@ -79,7 +79,7 @@ findprog() {
# #
if { findprog automake >/dev/null 2>/dev/null; } then if { findprog automake >/dev/null 2>/dev/null; } then
echo "- Could not find or run automake, I hope you know what you're doing!" echo "- Could not find or run automake, I hope you know what you are doing!"
else else
echo "Runs automake --include-deps" echo "Runs automake --include-deps"
automake --include-deps Makefile >/dev/null automake --include-deps Makefile >/dev/null

View File

@ -2361,7 +2361,7 @@ _libssh2_channel_write(LIBSSH2_CHANNEL *channel, int stream_id,
if(channel->local.close) if(channel->local.close)
return _libssh2_error(channel->session, return _libssh2_error(channel->session,
LIBSSH2_ERROR_CHANNEL_CLOSED, LIBSSH2_ERROR_CHANNEL_CLOSED,
"We've already closed this channel"); "We have already closed this channel");
else if(channel->local.eof) else if(channel->local.eof)
return _libssh2_error(channel->session, return _libssh2_error(channel->session,
LIBSSH2_ERROR_CHANNEL_EOF_SENT, LIBSSH2_ERROR_CHANNEL_EOF_SENT,

View File

@ -4,5 +4,5 @@ int test(LIBSSH2_SESSION *session)
{ {
return test_auth_keyboard(session, TEST_AUTH_SHOULDFAIL, return test_auth_keyboard(session, TEST_AUTH_SHOULDFAIL,
"libssh2", /* set in Dockerfile */ "libssh2", /* set in Dockerfile */
"I'm the wrong password"); "I am the wrong password");
} }

View File

@ -4,5 +4,5 @@ int test(LIBSSH2_SESSION *session)
{ {
return test_auth_password(session, TEST_AUTH_SHOULDFAIL, return test_auth_password(session, TEST_AUTH_SHOULDFAIL,
"libssh2", /* set in Dockerfile */ "libssh2", /* set in Dockerfile */
"I'm the wrong password"); "I am the wrong password");
} }

View File

@ -3,6 +3,6 @@
int test(LIBSSH2_SESSION *session) int test(LIBSSH2_SESSION *session)
{ {
return test_auth_password(session, TEST_AUTH_SHOULDFAIL, return test_auth_password(session, TEST_AUTH_SHOULDFAIL,
"I'm the wrong username", "I am the wrong username",
"my test password"); /* set in Dockerfile */ "my test password"); /* set in Dockerfile */
} }