.\" -*- 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 BEZEICHNUNG
systemd\-ssh\-proxy \- SSH\-Client\-Erweiterung für Verbindung zu \fBAF_VSOCK\fP\-
und \fBAF_UNIX\fP\-Sockets
.SH ÜBERSICHT
.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 BESCHREIBUNG
.PP
\fBsystemd\-ssh\-proxy\fP ist eine kleine »Proxy«\-Erweiterung für das Werkzeug
\fBssh\fP(1), die die Verbindung zu \fBAF_UNIX\fP\- und \fBAF_VSOCK\fP\-Sockets
ermöglicht\&. Sie implementiert die durch die Konfigurationsoption
\fIProxyCommand\fP von \fBssh\fP(1) definierte Schnittstelle\&. Sie ist dazu
gedacht, mit einem \fBssh_config\fP(5)\-Konfigurationsfragment der folgenden Art
verwandt zu werden.
.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
Ein Konfigurationsfragment dieser Art wird standardmäßig in
/etc/ssh/ssh_config\&.d/20\-systemd\-ssh\-proxy\&.conf installiert\&.
.PP
Ist dieses vorhanden, werden SSH\-Verbindungen mit der Rechnerzeichenkette
»unix/« gefolgt von einem absoluten Dateisystempfad zu einem
\fBAF_UNIX\fP\-Socket zu dem angegebenen Socket geleitet, der vom Typ
\fBSOCK_STREAM\fP sein muss\&. Ähnlich werden SSH\-Verbindungen zu »vsock/«
gefolgt von einer \fBAF_VSOCK\fP\-CID dazu führen, dass eine SSH\-Verbindung zu
dieser CID aufgebaut wird\&. »vsock\-mux/« gefolgt von einem absoluten
\fBAF_UNIX\fP\-Dateisystempfad zu einem Socket ist ähnlich, aber für
Cloud\-Hypervisor/Firecracker, die keine direkte \fBAF_VSOCK\fP\-Kommunikation
zwischen dem Wirt und dem Gast erlauben und ihren eigenen Multiplexer über
\fBAF_UNIX\fP\-Sockets bereitstellen\&. Siehe \m[blue]\fBCloud\-hypervisor VSOCK\-Unterstützung\fP\m[]\&\s-2\u[1]\d\s+2 and \m[blue]\fBVerwendung des Firecracker Virtio\-Vsock\-Gerätes\fP\m[]\&\s-2\u[2]\d\s+2\&. Beachten Sie, dass
»%« anstelle von »/« als Trenner verwandt werden kann, um mit Werkzeugen wie
\fBscp\fP(1) und \fBrsync\fP(1) kompatibel zu sein\&.
.PP
Desweiteren wird eine Verbindung zu »\&.host« zu einer Verbindung zu der
lokalen Maschine mittels SSH führen, ohne das Netzwerk zu verwenden\&.
.PP
Dieses Werkzeug ist dazu gedacht, zusammen mit \fBsystemd\-ssh\-generator\fP(8)
verwandt zu werden, das bei der Ausführung innerhalb einer VM oder eines
Containers SSH an geeignete Adressen anbindet\&. \fBsystemd\-ssh\-generator\fP
ist dazu gedacht, innerhalb des Containers oder eines VM\-Gastes verwandt zu
werden und \fBsystemd\-ssh\-proxy\fP wird auf dem Wirt ausgeführt, damit zu dem
Container oder VM\-Gast verbunden wird\&.
.SH EXIT\-STATUS
.PP
Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich
Null\&.
.SH BEISPIELE
.PP
\fBBeispiel\ \&1.\ \&Kommunikation mit einer lokalen VM mit CID 4711\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh vsock/4711
.fi
.if  n \{\
.RE
.\}
.PP
\fBBeispiel\ \&2.\ \&Kommunikation mit einem VM\-Gast, der mit Cloud\-Hypervisor/Firecracker\fP betrieben wird
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh vsock\-mux/run/vm\-1234\&.sock
.fi
.if  n \{\
.RE
.\}
.PP
\fBBeispiel\ \&3.\ \&Kommunikation mit dem lokalen Rechner mittels ssh\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh \&.host
.fi
.if  n \{\
.RE
.\}
.PP
oder äquivalent:
.sp
.if  n \{\
.RS 4
.\}
.nf
ssh unix/run/ssh\-unix\-local/socket
.fi
.if  n \{\
.RE
.\}
.PP
\fBBeispiel\ \&4.\ \&Kopieren einer lokalen Datei »foo« in eine lokale VM mit CID 1348\fP
.sp
.if  n \{\
.RS 4
.\}
.nf
scp foo vsock%1348:
.fi
.if  n \{\
.RE
.\}
.SH "SIEHE AUCH"
.PP
\fBsystemd\fP(1), \fBsystemd\-ssh\-generator\fP(8), \fBvsock\fP(7), \fBunix\fP(7),
\fBssh\fP(1), \fBsshd\fP(8)
.SH ANMERKUNGEN
.IP " 1." 4
Cloud\-Hypervisor VSOCK\-Unterstützung
.RS 4
\%https://github.com/cloud\-hypervisor/cloud\-hypervisor/blob/main/docs/vsock.md
.RE
.IP " 2." 4
Verwendung des Firecracker Virtio\-Vsock\-Gerätes
.RS 4
\%https://github.com/firecracker\-microvm/firecracker/blob/main/docs/vsock.md
.RE
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .