unofficial mirror of 
 help / color / mirror / Atom feed
* [ANN] Guile-SSH 0.14.0 released
@ 2021-12-20 18:48 Artyom V. Poptsov
  0 siblings, 0 replies; only message in thread
From: Artyom V. Poptsov @ 2021-12-20 18:48 UTC (permalink / raw)
  To: Guile Users' Mailing List

[-- Attachment #1: Type: text/plain, Size: 5823 bytes --]

Hello Guilers,

I'm pleased to announce Guile-SSH 0.14.0:

As usual, this release tag is signed with my GPG key[1].

There are lots of changes; please see the full list of the user-visible
changes below.

My tests of the new release have shown no errors, but I'm aware that
some bugs may still be lurking inside so if you're a Guile-SSH user --
please test it and report me any errors; I'd appreciate it.

* What is Guile-SSH?

Guile-SSH is a library that provides access to the SSH protocol[2] for
programs written in GNU Guile interpreter.  It is built upon the
libssh[3] library.

Currently Guile-SSH provides the following features:
  - The API that is sufficient for building of standalone SSH clients and
    servers, or for embedding client/server functionality in your lispy Scheme
  - Several authentication methods are supported, including password
    authentication, public key and SSH agent authentication methods.
  - Key management procedures: you can make key pairs, read keys from files,
    get key hashes, get public keys from private keys etc.  DSS, RSA, RSA1 and
    ECDSA (by means of OpenSSL) are supported.
  - Port forwarding procedures and high-level API for creating of SSH tunnels.
  - Distributed forms ('dist-map', 'distribute', ...) that allow to spread the
    evaluation of Scheme code between remote hosts.  Or you can just connect
    to a remote REPL from Scheme using 'with-ssh' procedure and evaluate some
    expressions.  No special server needed on the remote side, just an SSH
    daemon and GNU Guile installed!
  - SFTP client API allows you to read and write remote files over the SSH
    protocol right from the Scheme code.
  - Remote popen API that allows you to make either input, output or
    bidirectional pipes to remote processes.
  - Detailed documentation in Texinfo format with examples included, even more
    examples in 'examples' directory.
  - Procedures for interaction with SSH agents.

* The list of user-visible changes

Here's the list of user-visible changes (an excerpt from NEWS file):

--8<---------------cut here---------------start------------->8---
* Changes in version 0.14.0 (2021-12-20)
** API change: OpenSSH agent procedures are now in (ssh agent)
   Move agent procedures to (ssh agent) module from (ssh auth).

   The procedures are renamed and improved too. The current set of procedures
   provided by (ssh agent) is as follows:
   - ssh-agent-sock-get
   - ssh-agent-sock-set!
   - ssh-agent-start
   - ssh-agent-info

   The documentation is updated accordingly.
** API change: Remove 'sftp-init' from (ssh sftp)
   This procedure was not present in the module anyway, so this is more like a
   bugfix though.

   If you need to call SFTP init, you can use low-level '%sftp-init' procedure
   (although this is discouraged.)
** Guile-SSH channels are now explicitly blocking by default
** Fix snarfing errors on Fedora GNU/Linux
   Guile-SSH would fail to find 'guile-snarf' script on Fedora GNU/Linux when
   GNU Guile 2.2 installed because the snarfer installed as 'guile-snarf2.2'.
   Now the problem is fixed.
** Fix random segfaults due to libssh logging
   The library would sometimes get segfaults due to libssh logging.

   Guile-SSH used to pass Guile objects to a libssh logging procedure as a
   opaque pointers, and some Guile objects didn't make it to the point when an
   actual Scheme callback procedure called, GC'ted on the way. So when a
   Scheme logging callback tried to use its parameters, the parameters was
   freed already.

   Now Guile-SSH bypasses libssh logging altogether, calling a Scheme logging
   callback right away -- that provides more control over Scheme objects and
   allows to keep them from GC'ing.
** Fix "random" errors and segfaults in channels
   Guile-SSH would sometimes fail with segmentation faults and other errors
   when a remote side is abruptly closed the connection and the client side
   still tries to read data.

   Now in that situation reading a Guile-SSH channel results in EOF.
** Fix test failures due to 'primitive-fork' calls
   SRFI-64 doesn't really like tests that spawn new processes and try to do
   stuff after 'primitive-fork' without calling 'execle' (or similar)
   procedure: sometimes a test would fail even when all its test cases where

   Now that should be fixed.

** Fix the tests for Guile 3.0.7
   There are differences in REPL welcome message between Guile 3.0.7 and older
   versions.  Now this difference is handled properly.

   Reported by Ludovic Courtès in

** Fix the tests for Guile 3.0.5
   The test-runner object is now reset to #f when calling the 'test-end'
   procedure. See the commit de5d1a7f99b8e952b115237ebc29633062f99bb9 in Guile
   (srfi-64: Reset test-runner-current if done) which introduced this change.

** The Guile-SSH building process now less verbose

** Update documentation
--8<---------------cut here---------------end--------------->8---

Many thanks to all the people who helped me with bug reports, pull
requests and other hints.  I added all contributors to "AUTHORS" and
"THANKS" files -- please let me know if I forgot to thank someone or
if there any typos.

- Artyom


Artyom "avp" Poptsov <>
Home page:
CADR Hackerspace co-founder:
GPG: D0C2 EAC1 3310 822D 98DE  B57C E9C5 A2D9 0898 A02F

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 487 bytes --]

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2021-12-20 18:48 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-12-20 18:48 [ANN] Guile-SSH 0.14.0 released Artyom V. Poptsov

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).