mirror of
git://anongit.mindrot.org/openssh.git
synced 2024-11-24 02:02:10 +08:00
34132e54cb
- [sshd.c sshd.8 sshconnect.c ssh.h ssh.c servconf.h servconf.c scp.1] [scp.c packet.h packet.c login.c log.c canohost.c channels.c] [hostfile.c sshd_config] ipv6 support: mostly gethostbyname->getaddrinfo/getnameinfo, new features: sshd allows multiple ListenAddress and Port options. note that libwrap is not IPv6-ready. (based on patches from fujiwara@rcac.tdi.co.jp) - [ssh.c canohost.c] more hints (hints.ai_socktype=SOCK_STREAM) for getaddrinfo, from itojun@ - [channels.c] listen on _all_ interfaces for X11-Fwd (hints.ai_flags = AI_PASSIVE) - [packet.h] allow auth-kerberos for IPv4 only - [scp.1 sshd.8 servconf.h scp.c] document -4, -6, and 'ssh -L 2022/::1/22' - [ssh.c] 'ssh @host' is illegal (null user name), from karsten@gedankenpolizei.de - [sshconnect.c] better error message - [sshd.c] allow auth-kerberos for IPv4 only - Big IPv6 merge: - Cleanup overrun in sockaddr copying on RHL 6.1 - Replacements for getaddrinfo, getnameinfo, etc based on versions from patch from KIKUCHI Takahiro <kick@kyoto.wide.ad.jp> - Replacement for missing structures on systems that lack IPv6 - record_login needed to know about AF_INET6 addresses - Borrowed more code from OpenBSD: rresvport_af and requisites
103 lines
4.1 KiB
Plaintext
103 lines
4.1 KiB
Plaintext
.\"
|
|
.\" Copyright (c) 1999 Markus Friedl. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by Markus Friedl.
|
|
.\" 4. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.TL
|
|
OpenSSH Channel Close Protocol 1.5 Implementation
|
|
.SH
|
|
Channel Input State Diagram
|
|
.PS
|
|
reset
|
|
l=1
|
|
s=1.2
|
|
ellipsewid=s*ellipsewid
|
|
boxwid=s*boxwid
|
|
ellipseht=s*ellipseht
|
|
S1: ellipse "INPUT" "OPEN"
|
|
move right 2*l from last ellipse.e
|
|
S4: ellipse "INPUT" "CLOSED"
|
|
move down l from last ellipse.s
|
|
S3: ellipse "INPUT" "WAIT" "OCLOSED"
|
|
move down l from 1st ellipse.s
|
|
S2: ellipse "INPUT" "WAIT" "DRAIN"
|
|
arrow "" "rcvd OCLOSE/" "shutdown_read" "send IEOF" from S1.e to S4.w
|
|
arrow "ibuf_empty/" "send IEOF" from S2.e to S3.w
|
|
arrow from S1.s to S2.n
|
|
box invis "read_failed/" "shutdown_read" with .e at last arrow.c
|
|
arrow from S3.n to S4.s
|
|
box invis "rcvd OCLOSE/" "-" with .w at last arrow.c
|
|
ellipse wid .9*ellipsewid ht .9*ellipseht at S4
|
|
arrow "start" "" from S1.w+(-0.5,0) to S1.w
|
|
arrow from S2.ne to S4.sw
|
|
box invis "rcvd OCLOSE/ " with .e at last arrow.c
|
|
box invis " send IEOF" with .w at last arrow.c
|
|
.PE
|
|
.SH
|
|
Channel Output State Diagram
|
|
.PS
|
|
S1: ellipse "OUTPUT" "OPEN"
|
|
move right 2*l from last ellipse.e
|
|
S3: ellipse "OUTPUT" "WAIT" "IEOF"
|
|
move down l from last ellipse.s
|
|
S4: ellipse "OUTPUT" "CLOSED"
|
|
move down l from 1st ellipse.s
|
|
S2: ellipse "OUTPUT" "WAIT" "DRAIN"
|
|
arrow "" "write_failed/" "shutdown_write" "send OCLOSE" from S1.e to S3.w
|
|
arrow "obuf_empty ||" "write_failed/" "shutdown_write" "send OCLOSE" from S2.e to S4.w
|
|
arrow from S1.s to S2.n
|
|
box invis "rcvd IEOF/" "-" with .e at last arrow.c
|
|
arrow from S3.s to S4.n
|
|
box invis "rcvd IEOF/" "-" with .w at last arrow.c
|
|
ellipse wid .9*ellipsewid ht .9*ellipseht at S4
|
|
arrow "start" "" from S1.w+(-0.5,0) to S1.w
|
|
.PE
|
|
.SH
|
|
Notes
|
|
.PP
|
|
The input buffer is filled with data from the socket
|
|
(the socket represents the local consumer/producer of the
|
|
forwarded channel).
|
|
The data is then sent over the INPUT-end (transmit-end) of the channel to the
|
|
remote peer.
|
|
Data sent by the peer is received on the OUTPUT-end (receive-end),
|
|
saved in the output buffer and written to the socket.
|
|
.PP
|
|
If the local protocol instance has forwarded all data on the
|
|
INPUT-end of the channel, it sends an IEOF message to the peer.
|
|
If the peer receives the IEOF and has consumed all
|
|
data he replies with an OCLOSE.
|
|
When the local instance receives the OCLOSE
|
|
he considers the INPUT-half of the channel closed.
|
|
The peer has his OUTOUT-half closed.
|
|
.PP
|
|
A channel can be deallocated by a protocol instance
|
|
if both the INPUT- and the OUTOUT-half on his
|
|
side of the channel are closed.
|
|
Note that when an instance is unable to consume the
|
|
received data, he is permitted to send an OCLOSE
|
|
before the matching IEOF is received.
|