1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
\input texinfo
@c -*-texinfo-*-
@c %**start of header
@setfilename guile-ssh.info
@documentencoding UTF-8
@settitle Guile-SSH Reference Manual
@c %**end of header
@include version.texi
@copying
This manual documents Guile-SSH version @value{VERSION}.
Copyright (C) 2014, 2015, 2016 Artyom V. Poptsov
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled ``GNU Free
Documentation License.''
@end copying
@dircategory The Algorithmic Language Scheme
@direntry
* Guile-SSH: (guile-ssh). Guile bindings to libssh.
@end direntry
@setchapternewpage odd
@titlepage
@sp 10
@title Guile-SSH Reference Manual
@subtitle For Guile-SSH @value{VERSION}
@author Artyom V. Poptsov
@page
@vskip 0pt plus 1filll
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
@finalout
@headings double
@ifnottex
@node Top, Introduction, (dir), (dir)
@top The Guile-SSH Reference Manual
@insertcopying
@sp 1
@end ifnottex
@menu
* Introduction::
* Installation::
* API Reference::
* Examples::
* Acknowledgments::
Appendices
* GNU Free Documentation License:: The license of this manual.
Indices
* Type Index::
* Concept Index::
@end menu
@contents
@node Introduction
@chapter Introduction
Guile-SSH is a library that provides access to the @acronym{SSH}
protocol for programs written in
@url{https://www.gnu.org/software/guile/, GNU Guile}. It is a wrapper
to the underlying @url{http://www.libssh.org/, libssh} library. This
manual is partly based on libssh documentation.
@node Installation
@chapter Installation
Guile-SSH sources are available from GitHub at
@url{https://github.com/artyom-poptsov/guile-ssh/}. This section
describes requirements of Guile-SSH and installation process.
Guile-SSH depends on the following packages:
@itemize
@item @url{https://www.gnu.org/software/guile/, GNU Guile}, version 2.0.9 or later
@item @url{http://www.libssh.org/, libssh}, version 0.6.4 or later
@end itemize
Get the sources of Guile-SSH from GitHub:
@example
$ git clone git@@github.com:artyom-poptsov/guile-ssh.git
@end example
Configure the sources:
@example
$ cd guile-ssh/
$ autoreconf -if
$ ./configure
@end example
Build and install the library:
@example
$ make
$ make install
@end example
For a basic explanation of the installation of the package, see the
@file{INSTALL} file.
Please @strong{note} that you will need
@url{https://www.gnu.org/software/automake/, Automake} version 1.12 or
later to run self-tests with @command{make check} (but the library
itself can be built with older Automake version such as 1.11).
@strong{important} You probably want to call @command{configure} with
the @option{--with-guilesitedir} option so that this package is
installed in Guile's default path. But, if you don't know where your
Guile site directory is, run @command{configure} without the option,
and it will give you a suggestion.
@node API Reference
@chapter API Reference
@menu
* Sessions:: Session management
* Auth:: Authentication procedures
* Keys:: Public and private keys
* Channels:: Channel manipulation procedures
* Tunnels:: SSH tunnels
* Remote Pipes:: Creating of input, output or bidirectional pipes to remote
processes
* Logging:: Interface to the libssh logging
* Version:: Get information about versions
Guile-SSH Server API
* Servers:: Creating and managing Guile-SSH servers
* Messages:: Handling of messages
SFTP
* SFTP:: Guile-SSH SFTP client API.
Distributed Computing
* Distributed Forms::
@end menu
@include api-auth.texi
@include api-channels.texi
@include api-tunnels.texi
@include api-sessions.texi
@include api-keys.texi
@include api-messages.texi
@include api-servers.texi
@include api-logging.texi
@include api-version.texi
@include api-dist.texi
@include api-sftp.texi
@include api-popen.texi
@include examples.texi
@node Acknowledgments
@chapter Acknowledgments
The @url{http://www.libssh.org/, libssh} that is used by Guile-SSH is
initially written by Aris Adamantiadis and being developed by the
developer community. See AUTHORS file that comes along with libssh
distribution for full authors list.
Thanks to the following people who contributed to Guile-SSH
through bug reports or patches:
@itemize @bullet
@item Ludovic Courtès @email{ludo@@gnu.org}
@end itemize
Thank you.
@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include fdl.texi
@include indices.texi
@bye
|
