.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-SSH\-PROXY 1 "" "systemd 260.1" systemd\-ssh\-proxy
.ie  \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH NOM
systemd\-ssh\-proxy – Greffon de client SSH pour une connexion aux sockets
\fBAF_VSOCK\fP et \fBAF_UNIX\fP
.SH SYNOPSIS
.sp
.nf
Host unix/* unix%* vsock/* vsock%* vsock\-mux/* vsock\-mux%*
    ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy %h %p
    ProxyUseFdpass yes
.fi
.HP \w'\fB/usr/lib/systemd/systemd\-ssh\-proxy\fR\ 'u
\fB/usr/lib/systemd/systemd\-ssh\-proxy\fP [ADRESSE] [PORT]
.SH DESCRIPTION
.PP
\fBsystemd\-ssh\-proxy\fP est un petit greffon « mandataire » pour l’outil
\fBssh\fP(1) qui permet une connexion aux sockets \fBAF_UNIX\fP et
\fBAF_VSOCK\fP\&. Il met en œuvre l’option de configuration \fIProxyCommand\fP de
\fBssh\fP\&. Il est censé être utilisé avec un élément de configuration de
\fBssh_config\fP(5) tel que ce qui suit :
.sp
.if  n \{\
.RS 4
.\}
.nf
Host unix/* unix%* vsock/* vsock%* vsock\-mux/* vsock\-mux%*
    ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy %h %p
    ProxyUseFdpass yes
    CheckHostIP no

Host \&.host
    ProxyCommand /usr/lib/systemd/systemd\-ssh\-proxy unix/run/ssh\-unix\-local/socket %p
    ProxyUseFdpass yes
    CheckHostIP no
.fi
.if  n \{\
.RE
.\}
.PP
Un élément de configuration avec ces lignes est par défaut installé dans
\fI/etc/ssh/ssh_config\&.d/20\-systemd\-ssh\-proxy\&.conf\fP\&.
.PP
With this in place, SSH connections to host string "unix/" followed by an
absolute \fBAF_UNIX\fP file system path to a socket will be directed to the
specified socket, which must be of type \fBSOCK_STREAM\fP\&. Similar, SSH
connections to "vsock/" followed by an \fBAF_VSOCK\fP CID will result in an SSH
connection made to that CID\&.  "vsock\-mux/" followed by an absolute
\fBAF_UNIX\fP file system path to a socket is similar but for
cloud\-hypervisor/firecracker which do not allow direct \fBAF_VSOCK\fP
communication between the host and guests, and provide their own multiplexer
over \fBAF_UNIX\fP sockets\&. See \m[blue]\fBcloud\-hypervisor VSOCK support\fP\m[]\&\s-2\u[1]\d\s+2 and \m[blue]\fBUsing the Firecracker Virtio\-vsock Device\fP\m[]\&\s-2\u[2]\d\s+2\&. Note that "%" can be used as a
separator instead of "/" to be compatible with tools like "scp" and
"rsync"\&.
.PP
De plus, une connexion vers « \&.host » aboutira à une connexion à l’hôte
local à l’aide de SSH sans utiliser d’interconnexion au réseau\&.
.PP
Cet outil est censé être utilisé avec \fBsystemd\-ssh\-generator\fP(8) qui,
lorsqu’exécuté dans une machine virtuelle ou un conteneur, lie SSH aux
adresses adéquates\&. \fBsystemd\-ssh\-generator\fP est censé être exécuté dans
un conteneur ou un client de machine virtuelle et \fBsystemd\-ssh\-proxy\fP est
exécuté sur l’hôte pour se connecter au conteneur ou au client de machine
virtuelle\&.
.SH "CODE DE RETOUR"
.PP
En cas de succès, \fB0\fP est renvoyé, autrement, un code d'échec différent de
zéro est renvoyé\&.
.SH EXEMPLES
.PP
\fBExemple\ \&1.\ \&Connexion à une machine virtuelle locale avec le CID 4711\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh vsock/4711
.fi
.if  n \{\
.RE
.\}
.PP
\fBExample\ \&2.\ \&Connexion à un client de machine virtuelle hébergée avec cloud\-hypervisor/firecracker\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh vsock\-mux/run/vm\-1234\&.sock
.fi
.if  n \{\
.RE
.\}
.PP
\fBExemple\ \&3.\ \&Connexion à l’hôte local avec ssh\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh \&.host
.fi
.if  n \{\
.RE
.\}
.PP
ou équivalent\ :
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh unix/run/ssh\-unix\-local/socket
.fi
.if  n \{\
.RE
.\}
.PP
\fBExample\ \&4.\ \&Copy local \*(Aqfoo\*(Aq file to a local VM with CID 1348\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
scp foo vsock%1348:
.fi
.if  n \{\
.RE
.\}
.SH "VOIR AUSSI"
.PP
\fBsystemd\fP(1), \fBsystemd\-ssh\-generator\fP(8), \fBvsock\fP(7), \fBunix\fP(7),
\fBssh\fP(1), \fBsshd\fP(8)
.SH NOTES
.IP " 1." 4
prise en charge de cloud\-hypervisor VSOCK
.RS 4
\%https://github.com/cloud\-hypervisor/cloud\-hypervisor/blob/main/docs/vsock.md
.RE
.IP " 2." 4
Utiliser le dispositif Firecracker Virtio\-vsock
.RS 4
\%https://github.com/firecracker\-microvm/firecracker/blob/main/docs/vsock.md
.RE
.PP
.SH TRADUCTION
La traduction française de cette page de manuel a été créée par
Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .