CHANGES

   1
   2 Corrections:
   3         Socat 1.7.4.2 did not compile on OmniOS (and probably other OpenSolaris
   4         distributions)
   5         Thanks to Andy Fiddaman for sending a patch
   6
   7 ####################### V 1.7.4.2:
   8
   9 Corrections:
  10         The per address parameters for OpenSSL overlapped in memory with socket
  11         parameters. Magically this did not seem to cause problems except on
  12         MacOS Catalina that reported errors like:
  13         socat[3458] E Select(7, &0x80, NULL, NULL, {140392884396544.000000}):
  14         Invalid argument
  15         Test: OPENSSL_PARA_OVERLAP
  16         Thanks to Ryo Ota for reporting this bug.
  17
  18         Fixed a few minor coding issues
  19
  20         A VSOCK warning message was generated with all listening addresses
  21         instead of only with VSOCK-LISTEN
  22
  23         When an OPENSSL-CONNECT client presented a certificate with IPv6
  24         subject alternate name and the OPENSSL-LISTEN server had no commonname
  25         option, the server crashed with SIGSEGV in xioip6_pton().
  26         Test: OPENSSL_CLIENT_IP6_CN
  27         Red Hat bug 1981308
  28         Thanks to Vlad Slepukhin for reporting this issue and providing a patch
  29
  30         Corrected a typo in configure.ac that broke option --enable-openssl-base
  31         Thanks to john1doe for reporting this issue.
  32
  33         Socat looped endlessly, not responding to SIGTERM, when a service name
  34         (for port) could not be resolved.
  35         Test: BAD_SERVICE
  36
  37         Using options of NAMED group, e.g.chown, with abstract UNIX domain
  38         sockets, produced errors because the function was applied with a normal
  39         file system related call, e.g.chown(), using file "" (empty name). Instead of
  40         chown(), Socat now uses fchown() on the file descriptor. However, such
  41         a call usually has no real effect.
  42         Test: ABSTRACT_USER
  43         Thanks to Andreas Fink for reporting this issue.
  44
  45         Option -R did not only dump ("sniff") right-to-left, but also
  46         left-to-right traffic to the given file.
  47         Test: SNIFF_RIGHT_TO_LEFT
  48         Thanks to 1314 gsf for reporting this bug and sending a patch.
  49
  50         Options -r and -R, when opening a named pipe that has no actual reader,
  51         failed with "No such device or address". To solve this problem, Socat
  52         now opens the pipe in rw-Mode.
  53         Thanks to Cody J.Soultz for sending a patch.
  54
  55         The call "socat -r - PIPE" traced to file ./- instead of issuing a
  56         syntax error.
  57
  58         Print a message when readbytes option causes EOF
  59
  60         The ip-recverr option had no effect. Corrected and improved its
  61         handling of ancilliary messages, so it is able to analyze ICMP error
  62         packets (Linux only?)
  63
  64         Setgui(), Setuid() calls in xio-progcall.c were useless.
  65
  66 Testing:
  67         Prevent the TIMESTAMP tests from sporadically failing due do seconds
  68         overflow
  69
  70         Fixed in test.sh a few issues reported by shellcheck
  71
  72 Documentation:
  73         Added missing docu of OpenSSL options min-proto-version,
  74         max-proto-version.
  75
  76         Added missing closing parenthesis in socat.yo.
  77         Thanks to Emanuele Torre for reporting this issue.
  78
  79         Corrected more typos and added missing bug info to CHANGES, performed
  80         some non functional corrections.
  81
  82 Porting:
  83         Corrected building when clock_gettime() not available, with or without
  84         gettimeofday().
  85
  86 ####################### V 1.7.4.1:
  87
  88 Corrections:
  89         Socat 1.7.4.0 failed to compile especially on 32 bit systems.
  90         Thanks to Wang Mingyu and others for sending a patch or reporting this
  91         issue.
  92
  93         Under certain conditions OpenSSL stream connections, in particular bulk
  94         data transfer in unidirectional mode, failed during transfer or near
  95         its with Connection reset by peer on receiver side.
  96         This happened with Socat versions 1.7.3.3 to 1.7.4.0. Reasons were
  97         lazy SSL shutdown handling on the sender side in combination with
  98         SSL_MODE_AUTO_RETRY turned off.
  99         Fix: After SSH_shutdown but before socket shutdown call SSL_read()
 100         Test: OPENSSL_STREAM_TO_SERVER
 101         Fixes Red Hat issue 1870279.
 102
 103 ####################### V 1.7.4.0:
 104
 105 Security:
 106         Buffer size option (-b) is internally doubled for CR-CRLF conversion,
 107         but not checked for integer overflow. This could lead to heap based
 108         buffer overflow, assuming the attacker could provide this parameter.
 109         Test: BLKSIZE_INT_OVERFL
 110         Thanks to Lê Hiếu Bùi for reporting this issue and sending an
 111         example exploit.
 112
 113 Corrections:
 114         Socats address parser read over end of string when there were unbalanced
 115         quotes
 116         Test: UNBALANCED_QUOTE
 117
 118         Removed unused usleep() call from sycls.c
 119
 120         Unsetenv() was conditional in sysutils.c but not in xio-openssl.c thus
 121         building failed on Solaris 9.
 122         Thanks to Greg Earle for reporting this issue and providing a patch.
 123
 124         Mitigated race condition of quickly terminating SYSTEM or EXEC child
 125         processes.
 126
 127         Option o-direct might require alignment of read/write buffer to, e.g.,
 128         512 bytes, Socat now takes care of this when allocating the buffer.
 129         With this fix read() succeeds, however, write() still might fail when
 130         not writing complete pages.
 131         Test: O_DIRECT
 132
 133         There was a race condition in the way Socat UDP-RECVFROM and similar
 134         addresses with option fork prevents one packet from triggering
 135         multiple processes. The symptom was that Socat master process seemed to
 136         hang and did not process further packets. The fix makes use of
 137         pselect() system call.
 138         Thanks to Fulvio Scapin for reporting this issue.
 139
 140         UNIX domain client addresses applied file system entry options (group
 141         NAMED) to the server socket instead of the client (bind) socket entry.
 142         Tests: UNIX_SENDTO_UNLINK UNIX_CONNECT_UNLINK
 143         Thanks to Nico Williams for reporting this major issue.
 144
 145         Length of single address options was limited to 511 bytes. This value
 146         is now increased to 2047 bytes.
 147         Change suggested by Mario Camou.
 148
 149         Addresses of type RECVFROM with option fork looped with an error
 150         message in case that the second address failed before consuming the
 151         packet. The fix makes RECVFROM drop the packet when the second address
 152         failed before reading it. Use retry or forever option with the second
 153         address if you want to avoid data loss.
 154         Fixes Red Hat bug 1907718
 155         Thanks to Chunmei Xu for reporting this issue and proving the patch.
 156
 157         Socats DTLS implementation has been reworked and appears to work now
 158         reasonably over UDP.
 159         New addresses: OPENSSL-DTLS-SERVER (DTLS-L),
 160                 OPENSSL-DTLS-CLIENT (DTLS)
 161         Tests: OPENSSL_DTLS_CLIENT OPENSSL_DTLS_SERVER
 162                 OPENSSL_METHOD_DTLS1 OPENSSL_METHOD_DTLS1.2
 163         Thanks to Brandon Carpenter, Qing Wan, and Pavel Nakonechnyi for
 164         sending patches.
 165
 166         filan did not output the socket protocol.
 167         filan -s assumed each stream socket to be TCP and each datagram socket
 168         to be UDP. Now it uses SO_PROTOCOL and getprotoent() for correct output.
 169
 170         Help text showed two parameters for UDP4-RECVFROM address, but only
 171         <port> is allowed.
 172         Thanks to John the Scott for reporting this issue.
 173
 174         Error messages from SSL_read() and SSL_write() sometimes stated
 175         SSL_connect instead of originating function name.
 176
 177         Fixed some more non functional minor issues.
 178
 179 Porting:
 180         In gcc version 10 the default changed from -fcommon to -fno-common.
 181         Consequently, linking filan and procan failed with error
 182         "multiple definition of `deny_severity'" and `allow_severity'
 183         Fixed by removing definitions in filan.c and procan.c
 184         Debian issue 957823
 185         Thanks to László Böszörményi and others for reporting this issue.
 186
 187         Solaris 9 does not provide strndup(); added substitute code.
 188         Thanks to Greg Earle for providing a patch.
 189
 190         Added configure option --enable-openssl-base to specify the location of
 191         a non-OS OpenSSL installation
 192
 193         There are systems whose kernel understands SCTP but getaddrinfo does
 194         not. As workaround after EIA_SOCKTYPE on name and service resolution
 195         fall back to ai_socktype=0; if it fails with EAI_SERVICE, set
 196         ai_protocol=0 and try again
 197         Test: SCTP_SERVICENAME
 198
 199         Per file filesystem options were still named ext2-* and depended on
 200         <linux/ext2_fs.h>. Now they are called fs-* and depend on <linux/fs.h>.
 201         These fs-* options are also available on old systems with ext2_fs.h
 202
 203         New options openssl-min-proto-version (min-version) and
 204         openssl-max-proto-version (max-version) give access to the related
 205         OpenSSL set-macros and substitute deprecated version-specific methods.
 206         Test: OPENSSL_MIN_VERSION
 207
 208         With OpenSSL use OPENSSL_init_SSL when available, instead of deprecated
 209         SSL_library_init.
 210
 211         With OPENSSL_API_COMPAT=0x10000000L the files openssl/dh.h, openssl/bn.h
 212         must explicitely be included.
 213         Thanks to Rosen Penev for reporting and sending a patch.
 214
 215 Testing:
 216         test.sh now produces a list of tests that could not be performed for
 217         any reason. This helps to analyse these cases.
 218
 219         OpenSSL s_server appearently started to neglect TCPs half close feature.
 220         Test OPENSSL_TCP4 has been changed to tolerate this.
 221
 222         OpenSSL changed its behaviour when connection is rejected. Tests
 223         OPENSSLCERTSERVER, OPENSSL_CN_CLIENT_SECURITY, and
 224         OPENSSL_CN_SERVER_SECURITY now tolerate this.
 225
 226         OpenSSL no longer allows explicit renegotiation with TLSv1.3, thus the
 227         appropriate tests failed.
 228         Fix: use TLSv1.2 for renegotiation tests
 229         Tests: OPENSSLRENEG1 OPENSSLRENEG2
 230
 231         Ubuntu 20.04 requires 2048 bit certificates with OpenSSL
 232
 233         Archlinux 2020 has not which command; its ip,ss commands have modified
 234         version strings
 235
 236         More testing issues solved:
 237         * ss to pipe might omit column separator
 238         * UDP6MULTICAST_UNIDIR fails on newer Linux kernels
 239         * do not use sort -V
 240         * renamed testaddrs() to testfeats(), and introduced new testaddrs()
 241
 242 New features:
 243         GOPEN and UNIX-CLIENT addresses now support sockets of type SEQPACKET.
 244         Test: GOPENUNIXSEQPACKET
 245         Feature suggested by vi0oss.
 246
 247         The generic setsockopt-int and related options are, in case of
 248         listening/accepting addresses, applied to the connected socket(s). To enable
 249         setting options on the listening socket, a new option setsockopt-listen
 250         has been implemented. See the documentation for info on data types.
 251         Tests: SETSOCKOPT SETSOCKOPT_LISTEN
 252         Thanks to Steven Danna and Korian Edeline for reporting this issue.
 253
 254         Filan option -S gives short description like -s but with improved
 255         format
 256
 257         Socat OpenSSL client, when server was specified using IP address, did
 258         not verify connection on certificates SubjectAltName IP entries.
 259         Tests: OPENSSL_SERVERALTAUTH OPENSSL_SERVERALTIP4AUTH OPENSSL_SERVERALTIP6AUTH
 260         Fixes Red Hat bug 1805132
 261
 262         Added options -r and -R for raw dump of transferred data to files.
 263         Test: OPTION_RAW_DUMP
 264
 265         Added option ip-transparent (socket option IP_TRANSPARENT)
 266         Thanks to Wang Shanker for sending a patch.
 267
 268         OPENSSL-CONNECT now automatically uses the SNI feature, option
 269         openssl-no-sni turns it off. Option openssl-snihost overrides the value
 270         of option openssl-commonname or the server name.
 271         Tests: OPENSSL_SNI OPENSSL_NO_SNI
 272         Thanks to Travis Burtrum for providing the initial patch
 273
 274         New option accept-timeout (listen-timeout)
 275         Test: ACCEPTTIMEOUT
 276         Proposed by Roland
 277
 278         New option ip-add-source-membership
 279         Feature inspired by Brian (b f31415)
 280
 281         INCOMPATIBLE CHANGE: Address UDP-DATAGRAM now does not check peerport
 282         of replies, as it did up to version 1.7.3.4. Use option sourceport when
 283         you need the old behaviour.
 284         Test: UDP_DATAGRAM_SOURCEPORT
 285         Feature inspired by Hans Bueckler for SSDP inquiry (for UPnP)
 286
 287         New option proxy-authorization-file reads PROXY-CONNECT credentials
 288         from file and makes it possible to hide this data from the process
 289         table.
 290         Test: PROXYAUTHFILE
 291         Thanks to Charles Stephens for sending an initial patch.
 292
 293         Added AF_VSOCK support with VSOCK-CONNECT and VSOCK-LISTEN addresses.
 294         Developed by Stefano Garzarella.
 295
 296 Coding:
 297         Added printf formats for uint16_t etc.
 298
 299 Documentation:
 300         Address UDP-RECV does not support option fork.
 301         Thanks to Fulvio Scapin for reporting that mistake in docu.
 302
 303         TUN address documentation showed TCP for backend which may merge
 304         consecutive packets which causes data loss.
 305         Thanks to Tomasz Lakota for reporting this issue.
 306
 307 ####################### V 1.7.3.4:
 308
 309 Corrections:
 310         Header of xiotermios_speed() declared parameter unsigned int instead of
 311         speed_t, thus compiling failed on MacOS
 312         Thanks to Joe Strout and others for reporting this bug.
 313         Thanks to Andrew Childs and others for sending a patch.
 314
 315         Under certain circumstances, termios options of the first address were
 316         applied to the second address, resulting in error
 317         "Inappropriate ioctl for device"
 318         This affected version 1.7.3.3 only.
 319         Test: TERMIOS_PH_ALL
 320         Thanks to Ivan J. for reporting this issue.
 321
 322         Socat failed to compile when no poll() system call was found by
 323         configure.
 324         Thanks to Jason White for sending a patch.
 325
 326         Due to use of SSL_CTX_clear_mode() Socat failed to compile on old
 327         systems with, e.g., OpenSSL-0.9.8. Thanks to Simon Matter and Moritz B.
 328         for reporting this problem and sending initial patches.
 329
 330         getaddrinfo() in IP4-SENDTO and IP6-SENDTO addresses failed with
 331         "ai_socktype not supported" when protocol 6 was addressed.
 332         The fix removes the possibility to use service names with SCTP.
 333         Test: IP_SENDTO_6
 334         Thanks to Sören for sending an initial patch.
 335
 336         Under certain circumstances, Socat printed the "socket ... is at EOF"
 337         multiple times.
 338         Test: MULTIPLE_EOF
 339
 340         Newer parts of test.sh used substitutions ${x,,*} or ${x^^*} that are
 341         not implemented in older bash versions.
 342
 343 ####################### V 1.7.3.3:
 344
 345 Corrections:
 346         Makefile.in did not specify dependencies of filan on vsnprintf_r.o
 347         and snprinterr.o
 348         Added definition of FILAN_OBJS
 349         Thanks to Craig Leres, Clayton Shotwell, and Chris Packham for
 350         providing patches.
 351
 352         configure option --enable-msglevel did not work with numbers
 353
 354         The autoconf mechanism for determining SHIFT_OFFSET did not work when
 355         cross compiling.
 356         Thanks to Max Freisinger from Gentoo for sending a patch.
 357
 358         Socat still depended on obsolete gethostbyname() function, thus
 359         compiling with MUSL libc failed.
 360         Problem reported by Kennedy33.
 361
 362         The async signal safe diagnostic system used FDs 3 and 4 internally, so
 363         use of appropriate fdin or fdout led to failures.
 364         Test: DIAG_FDIN
 365         Problem reported by Onur Sentürk.
 366
 367         The socket based mechanism for passing messages and signal information
 368         from signal handler to process could reach and kill the wrong process.
 369         Introduces functions diag_sock_pair(), diag_fork()
 370         Thanks to Darren Zhao for analysing and reporting this problem.
 371
 372         Option ipv6-join-group did not work because it was applied in the wrong
 373         phase
 374         Test: UDP6MULTICAST_UNIDIR
 375         Thanks to Angus Gratton for sending a patch.
 376
 377         Setting ispeed and ospeed failed for some serial devices because the
 378         two settings were applied with two different get/set cycles, Thanks to
 379         Alexandre Fenyo for providing an initial patch.
 380         However, the actual fix is part of a conceptual change of the termios
 381         module that aims for applying all changes in a single tcsetaddr call.
 382         Fixes FreeBSD Bug 198441
 383
 384         Termios options TAB0,TAB1,TAB2,TAB3, and XTABS did not have an effect.
 385         Thanks to Alan Walters for reporting this bug.
 386
 387         Substituted cumbersom ISPEED_OFFSET mechanism for cfsetispeed() calls
 388
 389         With TCP6-LISTEN and the other passive IPv6 addresses the range option
 390         just failed: due to a bug in the syntax parser and two more bugs in
 391         the xiocheckrange_ip6() function.
 392         The syntax has now been changed from "[::1/128]" to "[::1]/128"!
 393         Thanks Leah Neukirchen for sending an initial fix.
 394
 395         For name resolution Socat only checked the first character of the host
 396         name to decide if it is an IPv4 address. This was not RFC conform. This
 397         fix removes the possibility for use of IPv4 addresses with IPv6, e.g.
 398         TCP6:127.0.0.1:80
 399         Debian issue 695885
 400         Thanks to Nicolas Fournil for reporting this issue.
 401
 402         Print a useful error message when single character options appear to be
 403         merged in Socat invocation
 404         Test: SOCAT_OPT_HINT
 405
 406         Fixed some docu typos.
 407         Thanks to Travis Wellman, Thomas <tjps636>, Dan Kenigsberg,
 408         Julian Zinn, and Simon Matter
 409
 410 Porting:
 411         OpenSSL functions TLS1_client_method() and similar are
 412         deprecated. Socat now uses recommended TLS_client_method(). The old
 413         functions and dependend option openssl-method can still be
 414         used when configuring socat with --enable-openssl-method
 415
 416         Shell scripts in socat distribution are now headed with:
 417         #! /usr/bin/env bash
 418         to make them better portable to systems without /bin/bash
 419         Thanks to Maya Rashish for sending a patch
 420
 421         RES_AAONLY, RES_PRIMARY are deprecated. You can still enable them with
 422         configure option --enable-res-deprecated.
 423
 424         New versions of OpenSSL preset SSL_MODE_AUTO_RETRY which may hang socat.
 425         Solution: clear SSL_MODE_AUTO_RETRY when it is set.
 426
 427         Renamed configure.in to configure.ac and set an appropriate symlink for
 428         older environments.
 429         Related Gentoo bug 426262: Warning on configure.in
 430         Thanks to Francesco Turco for reporting that warning.
 431
 432         Fixed new IPv6 range code for platforms without s6_addr32 component.
 433
 434 Testing:
 435         test.sh: Show a warning when phase-1 (insecure phase) of a security
 436         test fails
 437
 438         OpenSSL tests failed on actual Linux distributions. Measures:
 439         Increased key lengths from 768 to 1024 bits
 440         Added test.sh option -C to delete temp certs from prevsious runs
 441         Provide DH-parameter in certificate in PEM
 442         OpenSSL s_server option -verify 0 must be omitted
 443         OpenSSL authentication method aNULL no longer works
 444         Failure of cipher aNULL is not a failure
 445         Failure of methods SSL3 and SSL23 is desired
 446
 447         test.sh depended on ifconfig and netstat utilities which are no longer
 448         availabie in some distributions. test.sh now checks for and prefers
 449         ip and ss.
 450         Thanks to Ruediger Meier for reporting this problem.
 451
 452         More corrections to test.sh:
 453         Language settings could still influence test results
 454         netstat was still required
 455         Suppress usleep deprecated messag
 456         Force use of IPv4 with some certificates
 457         Set timeout for UDPxMAXCHILDREN tests
 458
 459 Git:
 460         Added missing Config/Makefile.DragonFly-2-8-2,
 461         Config/config.DragonFly-2-8-2.h
 462         Removed testcert.conf (to be generated by test.sh)
 463
 464 Cosmetics:
 465         Simplified handling of missing termios defines.
 466
 467 New features:
 468         Permit combined -d options as -dd etc.
 469
 470 porting:
 471         ext2 options are now fs options.
 472
 473 ####################### V 1.7.3.2:
 474
 475 corrections:
 476         SIGSEGV and other signals could lead to a 100% CPU loop
 477
 478         Failing name resolution could lead to SIGSEGV
 479         Thanks to Max for reporting this issue.
 480
 481         Include <stddef.h> for ptrdiff_t
 482         Thanks to Jeroen Roovers for reporting this issue.
 483
 484         Building with --disable-sycls failed due to missing sslcls.h defines
 485
 486         Socat hung when configured with --disable-sycls.
 487
 488         Some minor corrections with includes etc.
 489
 490         Option so-reuseport did not work. Thanks to Some Raghavendra Prabhu
 491         for sending a patch.
 492
 493         Programs invoked with EXEC, nofork, and -u or -U had stdin and stdout
 494         incorrectly assigned
 495         Test: EXEC_NOFORK_UNIDIR
 496         Thanks to David Reiss for reporting this problem.
 497
 498         Socat exited with status 0 even when a program invoked with SYSTEM or
 499         EXEC failed.
 500         Tests: SYSTEM_RC EXEC_RC
 501         Issue reported by Felix Winkelmann.
 502
 503         AddressSanitizer reported a few buffer overflows (false positives).
 504         Nevertheless fixed Socat source.
 505         Issue reported by Hanno Böck.
 506
 507         Socat did not use option ipv6-join-group.
 508         Test: USE_IPV6_JOIN_GROUP
 509         Thanks to Linus Lüssing for sending a patch.
 510
 511         UDP-LISTEN did not honor the max-children option.
 512         Test: UDP4MAXCHILDREN UDP6MAXCHILDREN
 513         Thanks to Leander Berwers for reporting this issue.
 514
 515         Options so-rcvtimeo and so-sndtimeo do not work with poll()/select()
 516         and therefore were useless.
 517         Thanks to Steve Borenstein for reporting this issue.
 518
 519         Option dhparam was documented as dhparams. Added the alias name
 520         dhparams to fix this.
 521         Thanks to Alexander Neumann for sending a patch.
 522
 523         Options shut-down and shut-close did not work.
 524         Thanks to Stefan Schimanski for providing a patch.
 525
 526         There was a bug in printing readline log message caused by a misleading
 527         indentation.
 528         Thanks to Paul Wouters for reporting.
 529
 530         The internal vsnprintf_r function looped or crashed on size parameter
 531         with hexadecimal output.
 532
 533         Ignore exit code of child process when it was killed by master due to
 534         EOF
 535
 536         Corrected byte order on read of IPV6_TCLASS value from ancillary
 537         message
 538
 539         Fixed type of the bool element in options. This had bug caused failures
 540         e.g. of ignoreeof on big-endian systems when bool was not based on int.
 541
 542         On systems with predefined bool type whose size differs from int some
 543         IPv6 and TCP options (per setsockopt()) failed.
 544
 545         Length of integral data in ancillary messages varies (TOS: 1 byte,
 546         TTL: 4 bytes), the old implementation failed for TTL on big-endian
 547         hosts.
 548
 549         Fixed an issue in options processing: TUN and DNS flags had failed on
 550         big-endian systems and the NO- forms had probable never worked.
 551
 552 porting:
 553         Type conflict between int and sig_atomic_t between declaration and
 554         definition of diag_immediate_type and diag_immediate_exit broke
 555         compilation on FreeBSD 10.1 with clang. Thanks to Emanuel Haupt for
 556         reporting this bug.
 557
 558         Socat failed to compile on platforms with OpenSSL without
 559         DTLSv1_client_method or DTLSv1_server_method.
 560         Thanks to Simon Matter for sending a patch.
 561
 562         NuttX OS headers do not provide struct ip, thus socat did not compile.
 563         Made struct ip subject to configure.
 564         Thanks to SP for reporting this issue.
 565
 566         Socat failed to compile with OpenSSL version 1.0.2d where
 567         SSLv3_server_method and SSLv3_client_method are no longer defined.
 568         Thanks to Mischa ter Smitten for reporting this issue and providing
 569         a patch.
 570
 571         configure checked for OpenSSL EC_KEY assuming it is a define but it
 572         is a type, thus OpenSSL ECDHE ciphers failed even on Linux.
 573         Thanks to Andrey Arapov for reporting this bug.
 574
 575         Changes to make socat compile with OpenSSL 1.1.
 576         Thanks to Sebastian Andrzej Siewior e.a. from the Debian team for
 577         providing the base patch.
 578         Debian Bug#828550
 579
 580         Make Socat compatible with BoringSSL.
 581         Thanks to Matt Braithwaite for providing a patch.
 582
 583         OpenSSL: Use RAND_status to determine PRNG state
 584         Thanks to Adam Langley for providing a patch
 585
 586         AIX-7 uses an extended O_ACCMODE that does not fit socat's internal
 587         requirements. Thanks to Garrick Trowsdale for providing a patch
 588
 589         LibreSSL support: check for OPENSSL_NO_COMP
 590         Thanks to Bernard Spil for providing a patch
 591
 592 testing:
 593         socks4echo.sh and socks4a-echo.sh hung with new bash with read -n
 594
 595         test.sh: stderr; option -v (verbose); FDOUT_ERROR description
 596
 597         improved proxy.sh - it now also takes hostnames
 598
 599         A few corrections in test.sh
 600
 601         DTLS1 test hangs on some distributions. Test is now only performed
 602         with OpenSSL 1.0.2 or higher.
 603
 604         More corrections to test.sh that reveal a mistake with IPV6_TCLASS
 605
 606 docu:
 607         Corrected source of socat man page to correctly show man references
 608         like socket(2); removed obseolete entries from See Also
 609
 610         Docu and some comments mentioned addresses SSL-LISTEN and SSL-CONNECT
 611         that do not exist (OPENSSL-LISTEN, SSL-L; and OPENNSSL-CONNECT, SSL
 612         are correct).
 613         Thanks to Zhigang Wang for reporting this issue.
 614
 615         Fixed a couple of English spelling and grammar mistakes.
 616         Thanks to Jakub Wild for sending the patches.
 617
 618         NOEXPAND() was not resolved 2 times.
 619
 620         More minor docu corrections
 621
 622 legal:
 623         Added contributors to copyright notices. Suggested by Matt Braithwaite.
 624
 625 ####################### V 1.7.3.1:
 626
 627 security:
 628         Socat security advisory 8
 629         A stack overflow in vulnerability was found that can be triggered when
 630         command line arguments (complete address specifications, host names,
 631         file names) are longer than 512 bytes.
 632         Successful exploitation might allow an attacker to execute arbitrary
 633         code with the privileges of the socat process.
 634         This vulnerability can only be exploited when an attacker is able to
 635         inject data into socat's command line.
 636         A vulnerable scenario would be a CGI script that reads data from clients
 637         and uses (parts of) this data as hostname for a Socat invocation.
 638         Test: NESTEDOVFL
 639         Credits to Takumi Akiyama for finding and reporting this issue.
 640
 641         Socat security advisory 7
 642         MSVR-1499
 643         In the OpenSSL address implementation the hard coded 1024 bit DH p
 644         parameter was not prime. The effective cryptographic strength of a key
 645         exchange using these parameters was weaker than the one one could get by
 646         using a prime p. Moreover, since there is no indication of how these
 647         parameters were chosen, the existence of a trapdoor that makes possible
 648         for an eavesdropper to recover the shared secret from a key exchange
 649         that uses them cannot be ruled out.
 650         Futhermore, 1024bit is not considered sufficiently secure.
 651         Fix: generated a new 2048bit prime.
 652         Thanks to Santiago Zanella-Beguelin and Microsoft Vulnerability
 653         Research (MSVR) for finding and reporting this issue.
 654
 655 ####################### V 1.7.3.0:
 656
 657 security:
 658         Socat security advisory 6
 659         CVE-2015-1379: Possible DoS with fork
 660         Fixed problems with signal handling caused by use of not async signal
 661         safe functions in signal handlers that could freeze socat, allowing
 662         denial of service attacks.
 663         Many changes in signal handling and the diagnostic messages system were
 664         applied to make the code async signal safe but still provide detailled
 665         logging from signal handlers:
 666         Coded function vsnprintf_r() as async signal safe incomplete substitute
 667         of libc vsnprintf()
 668         Coded function snprinterr() to replace %m in strings with a system error
 669         message
 670         Instead of gettimeofday() use clock_gettime() when available
 671         Pass Diagnostic messages from signal handler per unix socket to the main
 672         program flow
 673         Use sigaction() instead of signal() for better control
 674         Turn off nested signal handler invocations
 675         Thanks to Peter Lobsinger for reporting and explaining this issue.
 676
 677         Red Hat issue 1019975: add TLS host name checks
 678         OpenSSL client checks if the server certificates names in
 679         extensions/subjectAltName/DNS or in subject/commonName match the name
 680         used to connect or the value of the openssl-commonname option.
 681         Test: OPENSSL_CN_CLIENT_SECURITY
 682
 683         OpenSSL server checks if the client certificates names in
 684         extensions/subjectAltNames/DNS or subject/commonName match the value of
 685         the openssl-commonname option when it is used.
 686         Test: OPENSSL_CN_SERVER_SECURITY
 687
 688         Red Hat issue 1019964: socat now uses the system certificate store with
 689         OPENSSL when neither options cafile nor capath are used
 690
 691         Red Hat issue 1019972: needs to specify OpenSSL cipher suites
 692         Default cipherlist is now "HIGH:-NULL:-PSK:-aNULL" instead of empty to
 693         prevent downgrade attacks
 694
 695 new features:
 696         OpenSSL addresses set couple of environment variables from values in
 697         peer certificate, e.g.:
 698         SOCAT_OPENSSL_X509_SUBJECT, SOCAT_OPENSSL_X509_ISSUER,
 699         SOCAT_OPENSSL_X509_COMMONNAME,
 700         SOCAT_OPENSSL_X509V3_SUBJECTALTNAME_DNS
 701         Tests: ENV_OPENSSL_{CLIENT,SERVER}_X509_*
 702
 703         Added support for methods TLSv1, TLSv1.1, TLSv1.2, and DTLS1
 704         Tests: OPENSSL_METHOD_*
 705
 706         Enabled OpenSSL server side use of ECDHE ciphers. Feature suggested
 707         by Andrey Arapov.
 708
 709         Added a new option termios-rawer for ptys.
 710         Thanks to Christian Vogelgsang for pointing me to this requirement
 711
 712 corrections:
 713         Bind with ABSTRACT commands used non-abstract namespace (Linux).
 714         Test: ABSTRACT_BIND
 715         Thanks to Denis Shatov for reporting this bug.
 716
 717         Fixed return value of nestlex()
 718
 719         Option ignoreeof on the right address hung.
 720         Test: IGNOREEOF_REV
 721         Thanks to Franz Fasching for reporting this bug.
 722
 723         Address SYSTEM, when terminating, shut down its parent addresses,
 724         e.g. an SSL connection which the parent assumed to still be active.
 725         Test: SYSTEM_SHUTDOWN
 726
 727         Passive (listening or receiving) addresses with empty port field bound
 728         to a random port instead of terminating with error.
 729         Test: TCP4_NOPORT
 730
 731         configure with some combination of disable options produced config
 732         files that failed to compile due to missing IPPROTO_TCP.
 733         Thanks to Thierry Fournier for report and patch.
 734
 735         fixed a few minor bugs with OpenSSL in configure and with messages
 736
 737         Socat did not work in FIPS mode because 1024 instead of 512 bit DH prime
 738         is required. Thanks to Zhigang Wang for reporting and sending a patch.
 739
 740         Christophe Leroy provided a patch that fixes memory leaks reported by
 741         valgrind
 742
 743         Help for filan -L was bad, is now corrected to:
 744         "follow symbolic links instead of showing their properties"
 745
 746         Address options fdin and fdout were silently ignored when not applicable
 747         due to -u or -U option. Now these combinations are caught as errors.
 748         Test: FDOUT_ERROR
 749         Issue reported by Hendrik.
 750
 751         Added option termios-cfmakeraw that calls cfmakeraw() and is preferred
 752         over option raw which is now obsolote. On SysV systems this call is
 753         simulated by appropriate setting.
 754         Thanks to Youfu Zhang for reporting issue with option raw.
 755
 756 porting:
 757         Socat included <sys/poll.h> instead of POSIX <poll.h>
 758         Thanks to John Spencer for reporting this issue.
 759
 760         Version 1.7.2.4 changed the check for gcc in configure.ac; this
 761         broke cross compiling. The particular check gets reverted.
 762         Thanks to Ross Burton and Danomi Manchego for reporting this issue.
 763
 764         Debian Bug#764251: Set the build timestamp to a deterministic time:
 765         support external BUILD_DATE env var to allow to build reproducable
 766         binaries
 767
 768         Joachim Fenkes provided an new adapted spec file.
 769
 770         Type bool and macros Min and Max are defined by socat which led to
 771         compile errors when they were already provided by build framework.
 772         Thanks to Liyu Liu for providing a patch.
 773
 774         David Arnstein contributed a patch for NetBSD 5.1 including stdbool.h
 775         support and appropriate files in Config/
 776
 777         Lauri Tirkkonen contributed a patch regarding netinet/if_ether.h
 778         on Illumos
 779
 780         Changes for Openindiana: define _XPG4_2, __EXTENSIONS__,
 781         _POSIX_PTHREAD_SEMANTICS; and minor changes
 782
 783         Red Hat issue 1182005: socat 1.7.2.4 build failure missing
 784         linux/errqueue.h
 785         Socat failed to compile on on PPC due to new requirements for
 786         including <linux/errqueue.h> and a weakness in the conditional code.
 787         Thanks to Michel Normand for reporting this issue.
 788
 789 doc:
 790         In the man page the PTY example was badly formatted. Thanks to
 791         J.F.Sebastian for sending a patch.
 792
 793         Added missing CVE ids to security issues in CHANGES
 794
 795 testing:
 796         Do not distribute testcert.conf with socat source but generate it
 797         (and new testcert6.conf) during test.sh run.
 798
 799 ####################### V 1.7.2.4:
 800
 801 corrections:
 802         LISTEN based addresses applied some address options, e.g. so-keepalive,
 803         to the listening file descriptor instead of the connected file
 804         descriptor
 805         Thanks to Ulises Alonso for reporting this bug
 806
 807         make failed after configure with non gcc compiler due to missing
 808         include. Thanks to Horacio Mijail for reporting this problem
 809
 810         configure checked for --disable-rawsocket but printed
 811         --disable-genericsocket in the help text. Thanks to Ben Gardiner for
 812         reporting and patching this bug
 813
 814         In xioshutdown() a wrong branch was chosen after RECVFROM type addresses.
 815         Probably no impact.
 816         Thanks to David Binderman for reporting this issue.
 817
 818         procan could not cleanly format ulimit values longer than 16 decimal
 819         digits. Thanks to Frank Dana for providing a patch that increases field
 820         width to 24 digits.
 821
 822         OPENSSL-CONNECT with bind option failed on some systems, eg.FreeBSD, with
 823         "Invalid argument"
 824         Thanks to Emile den Tex for reporting this bug.
 825
 826         Changed some variable definitions to make gcc -O2 aliasing checker happy
 827         Thanks to Ilya Gordeev for reporting these warnings
 828
 829         On big endian platforms with type long >32bit the range option applied a
 830         bad base address. Thanks to hejia hejia for reporting and fixing this bug.
 831
 832         Red Hat issue 1022070: missing length check in xiolog_ancillary_socket()
 833
 834         Red Hat issue 1022063: out-of-range shifts on net mask bits
 835
 836         Red Hat issue 1022062: strcpy misuse in xiosetsockaddrenv_ip4()
 837
 838         Red Hat issue 1022048: strncpy hardening: corrected suspicious strncpy()
 839         uses
 840
 841         Red Hat issue 1021958: fixed a bug with faulty buffer/data length
 842         calculation in xio-ascii.c:_xiodump()
 843
 844         Red Hat issue 1021972: fixed a missing NUL termination in return string
 845         of sysutils.c:sockaddr_info() for the AF_UNIX case
 846
 847         fixed some typos and minor issues, including:
 848         Red Hat issue 1021967: formatting error in manual page
 849
 850         UNIX-LISTEN with fork option did not remove the socket file system entry
 851         when exiting. Other file system based passive address types had similar
 852         issues or failed to apply options umask, user e.a.
 853         Thanks to Lorenzo Monti for pointing me to this issue
 854
 855 porting:
 856         Red Hat issue 1020203: configure checks fail with some compilers.
 857         Use case: clang
 858
 859         Performed changes for Fedora release 19
 860
 861         Adapted, improved test.sh script
 862
 863         Red Hat issue 1021429: getgroupent fails with large number of groups;
 864         use getgrouplist() when available instead of sequence of calls to
 865         getgrent()
 866
 867         Red Hat issue 1021948: snprintf API change;
 868         Implemented xio_snprintf() function as wrapper that tries to emulate C99
 869         behaviour on old glibc systems, and adapted all affected calls
 870         appropriately
 871
 872         Mike Frysinger provided a patch that supports long long for time_t,
 873         socklen_t and a few other libc types.
 874
 875         Artem Mygaiev extended Cedril Priscals Android build script with pty code
 876
 877         The check for fips.h required stddef.h
 878         Thanks to Matt Hilt for reporting this issue and sending a patch
 879
 880         Check for linux/errqueue.h failed on some systems due to lack of
 881         linux/types.h inclusion. Thanks to Michael Vastola for sending a patch.
 882
 883         autoconf now prefers configure.ac over configure.in
 884         Thanks to Michael Vastola for sending a patch.
 885
 886         type of struct cmsghdr.cmsg is system dependend, determine it with
 887         configure; some more print format corrections
 888
 889 docu:
 890         libwrap always logs to syslog
 891
 892         added actual text version of GPLv2
 893
 894 ####################### V 1.7.2.3:
 895
 896 security:
 897         Socat security advisory 5
 898         CVE-2014-0019: socats PROXY-CONNECT address was vulnerable to a buffer
 899         overflow with data from command line (see socat-secadv5.txt)
 900         Credits to Florian Weimer of the Red Hat Product Security Team
 901
 902 ####################### V 1.7.2.2:
 903
 904 security:
 905         Socat security advisory 4
 906         CVE-2013-3571:
 907         after refusing a client connection due to bad source address or source
 908         port socat shutdown() the socket but did not close() it, resulting in
 909         a file descriptor leak in the listening process, visible with lsof and
 910         possibly resulting in EMFILE Too many open files. This issue could be
 911         misused for a denial of service attack.
 912         Full credits to Catalin Mitrofan for finding and reporting this issue.
 913
 914 ####################### V 1.7.2.1:
 915
 916 security:
 917         Socat security advisory 3
 918         CVE-2012-0219:
 919         fixed a possible heap buffer overflow in the readline address. This bug
 920         could be exploited when all of the following conditions were met:
 921         1) one of the addresses is READLINE without the noprompt and without the
 922         prompt options.
 923         2) the other (almost arbitrary address) reads malicious data (which is
 924         then transferred by socat to READLINE).
 925         Workaround: when using the READLINE address apply option prompt or
 926         noprompt.
 927         Full credits to Johan Thillemann for finding and reporting this issue.
 928
 929 ####################### V 1.7.2.0:
 930
 931 corrections:
 932         when UNIX-LISTEN was applied to an existing file it failed as expected
 933         but removed the file. Thanks to Bjoern Bosselmann for reporting this
 934         problem
 935
 936         fixed a bug where socat might crash when connecting to a unix domain
 937         socket using address GOPEN. Thanks to Martin Forssen for bug report and
 938         patch.
 939
 940         UDP-LISTEN would alway set SO_REUSEADDR even without fork option and
 941         when user set it to 0. Thanks to Michal Svoboda for reporting this bug.
 942
 943         UNIX-CONNECT did not support half-close. Thanks to Greg Hughes who
 944         pointed me to that bug
 945
 946         TCP-CONNECT with option nonblock reported successful connect even when
 947         it was still pending
 948
 949         address option ioctl-intp failed with "unimplemented type 26". Thanks
 950         to Jeremy W. Sherman for reporting and fixing that bug
 951
 952         socat option -x did not print packet direction, timestamp etc; thanks
 953         to Anthony Sharobaiko for sending a patch
 954
 955         address PTY does not take any parameters but did not report an error
 956         when some were given
 957
 958         Marcus Meissner provided a patch that fixes invalid output and possible
 959         process crash when socat prints info about an unnamed unix domain
 960         socket
 961
 962         Michal Soltys reported the following problem and provided an initial
 963         patch: when socat was interrupted, e.g. by SIGSTOP, and resumed during
 964         data transfer only parts of the data might have been written.
 965
 966         Option o-nonblock in combination with large transfer block sizes
 967         may result in partial writes and/or EAGAIN errors that were not handled
 968         properly but resulted in data loss or process termination.
 969
 970         Fixed a bug that could freeze socat when during assembly of a log
 971         message a signal was handled that also printed a log message. socat
 972         development had been aware that localtime() is not thread safe but had
 973         only expected broken messages, not corrupted stack (glibc 2.11.1,
 974         Ubuntu 10.4)
 975
 976         an internal store for child pids was susceptible to pid reuse which
 977         could lead to sporadic data loss when both fork option and exec address
 978         were used. Thanks to Tetsuya Sodo for reporting this problem and
 979         sending a patch
 980
 981         OpenSSL server failed with "no shared cipher" when using cipher aNULL.
 982         Fixed by providing temporary DH parameters. Thanks to Philip Rowlands
 983         for drawing my attention to this issue.
 984
 985         UDP-LISTEN slept 1s after accepting a connection. This is not required.
 986         Thanks to Peter Valdemar Morch for reporting this issue
 987
 988         fixed a bug that could lead to error or socat crash after a client
 989         connection with option retry had been established
 990
 991         fixed configure.in bug on net/if.h check that caused IF_NAMESIZE to be
 992         undefined
 993
 994         improved dev_t print format definition
 995
 996 porting:
 997         Cedril Priscal ported socat to Android (using Googles cross compiler).
 998         The port includes the socat_buildscript_for_android.sh script
 999
1000         added check for component ipi_spec_dst in struct in_pktinfo so
1001         compilation does not fail on Cygwin (thanks to Peter Wagemans for
1002         reporting this problem)
1003
1004         build failed on RHEL6 due to presence of fips.h; configure now checks
1005         for fipsld too. Thanks to Andreas Gruenbacher for reporting this
1006         problem
1007
1008         check for netinet6/in6.h only when IPv6 is available and enabled
1009
1010         don't fail to compile when the following defines are missing:
1011         IPV6_PKTINFO IPV6_RTHDR IPV6_DSTOPTS IPV6_HOPOPTS IPV6_HOPLIMIT
1012         Thanks to Jerry Jacobs for reporting this problem (Mac OS X Lion 10.7)
1013
1014         check if define __APPLE_USE_RFC_2292 helps to enable IPV6_* (MacOSX
1015         Lion 7.1); thanks to Jerry Jacobs to reporting this problem and
1016         proposing a solution
1017
1018         fixed compiler warnings on Mac OS X 64bit. Thanks to Guy Harris for
1019         providing the patch.
1020
1021         corrections for OpenEmbedded, especially termios SHIFT values and
1022         ISPEED/OSPEED. Thanks to John Faith for providing the patch
1023
1024         minor corrections to docu and test.sh resulting from local compilation
1025         on Openmoko SHR
1026
1027         fixed sa_family_t compile error on DragonFly. Thanks to Tony Young for
1028         reporting this issue and sending a patch.
1029
1030         Ubuntu Oneiric: OpenSSL no longer provides SSLv2 functions; libutil.sh
1031         is now bsd/libutil.h; compiler warns on vars that is only written to
1032
1033 new features:
1034         added option max-children that limits the number of concurrent child
1035         processes. Thanks to Sam Liddicott for providing the patch.
1036
1037         Till Maas added support for tun/tap addresses without IP address
1038
1039         added an option openssl-compress that allows to disable the compression
1040         feature of newer OpenSSL versions. Thanks to Michael Hanselmann for
1041         providing this contribution (sponsored by Google Inc.)
1042
1043 docu:
1044         minor corrections in docu (thanks to Paggas)
1045
1046         client process -> child process
1047
1048 ####################### V 1.7.1.3:
1049
1050 security:
1051         Socat security advisory 2
1052         CVE-2010-2799:
1053         fixed a stack overflow vulnerability that occurred when command
1054         line arguments (whole addresses, host names, file names) were longer
1055         than 512 bytes.
1056         Note that this could only be exploited when an attacker was able to
1057         inject data into socat's command line.
1058         Full credits to Felix Gröbert, Google Security Team, for finding and
1059         reporting this issue
1060
1061 ####################### V 1.7.1.2:
1062
1063 corrections:
1064         user-late and group-late, when applied to a pty, affected the system
1065         device /dev/ptmx instead of the pty (thanks to Matthew Cloke for
1066         pointing me to this bug)
1067
1068         socats openssl addresses failed with "nonblocking operation did not
1069         complete" when the peer performed a renegotiation. Thanks to Benjamin
1070         Delpy for reporting this bug.
1071
1072         info message during socks connect showed bad port number on little
1073         endian systems due to wrong byte order (thanks to Peter M. Galbavy for
1074         bug report and patch)
1075
1076         Debian bug 531078: socat execs children with SIGCHLD ignored; corrected
1077         to default. Thanks to Martin Dorey for reporting this bug.
1078
1079 porting:
1080         building socat on systems that predefined the CFLAGS environment to
1081         contain -Wall failed (esp.RedHat). Thanks to Paul Wouters for reporting
1082         this problem and to Simon Matter for providing the patch
1083
1084         support for Solaris 8 and Sun Studio support (thanks to Sebastian
1085         Kayser for providing the patches)
1086
1087         on some 64bit systems a compiler warning "cast from pointer to integer
1088         of different size" was issued on some option definitions
1089
1090         added struct sockaddr_ll to union sockaddr_union to avoid "strict
1091         aliasing" warnings (problem reported by Paul Wouters)
1092
1093 docu:
1094         minor corrections in docu
1095
1096 ####################### V 1.7.1.1:
1097
1098 corrections:
1099         corrected the "fixed possible SIGSEGV" fix because SIGSEGV still might
1100         occur under those conditions. Thanks to Toni Mattila for first
1101         reporting this problem.
1102
1103         ftruncate64 cut its argument to 32 bits on systems with 32 bit long type
1104
1105         socat crashed on systems without setenv() (esp. SunOS up to Solaris 9);
1106         thanks to Todd Stansell for reporting this bug
1107
1108         with unidirectional EXEC and SYSTEM a close() operation was performed
1109         on a random number which could result in hanging e.a.
1110
1111         fixed a compile problem caused by size_t/socklen_t mismatch on 64bit
1112         systems
1113
1114         docu mentioned option so-bindtodev but correct name is so-bindtodevice.
1115         Thanks to Jim Zimmerman for reporting.
1116
1117 docu changes:
1118         added environment variables example to doc/socat-multicast.html
1119
1120 ####################### V 1.7.1.0:
1121
1122 new features:
1123         address options shut-none, shut-down, and shut-close allow to control
1124         socat's half close behaviour
1125
1126         with address option shut-null socat sends an empty packet to the peer
1127         to indicate EOF
1128
1129         option null-eof changes the behaviour of sockets that receive an empty
1130         packet to see EOF instead of ignoring it
1131
1132         introduced option names substuser-early and su-e, currently equivalent
1133         to option substuser (thanks to Mike Perry for providing the patch)
1134
1135 corrections:
1136         fixed some typos and improved some comments
1137
1138 ####################### V 1.7.0.1:
1139
1140 corrections:
1141         fixed possible SIGSEGV in listening addresses when a new connection was
1142         reset by peer before the socket addresses could be retrieved. Thanks to
1143         Mike Perry for sending a patch.
1144
1145         fixed a bug, introduced with version 1.7.0.0, that let client
1146         connections with option connect-timeout fail when the connections
1147         succeeded. Thanks to Bruno De Fraine for reporting this bug.
1148
1149         option end-close "did not apply" to addresses PTY, SOCKET-CONNECT,
1150         and most UNIX-* and ABSTRACT-*
1151
1152         half close of EXEC and SYSTEM addresses did not work for pipes and
1153         sometimes socketpair
1154
1155         help displayed for some option a wrong type
1156
1157         under some circumstances shutdown was called multiple times for the
1158         same fd
1159
1160 ####################### V 1.7.0.0:
1161
1162 new features:
1163         new address types SCTP-CONNECT and SCTP-LISTEN implement SCTP stream
1164         mode for IPv4 and IPv6; new address options sctp-maxseg and
1165         sctp-nodelay (suggested by David A. Madore; thanks to Jonathan Brannan
1166         for providing an initial patch)
1167
1168         new address "INTERFACE" for transparent network interface handling
1169         (suggested by Stuart Nicholson)
1170
1171         added generic socket addresses: SOCKET-CONNECT, SOCKET-LISTEN,
1172         SOCKET-SENDTO, SOCKET-RECVFROM, SOCKET-RECV, SOCKET-DATAGRAM allow
1173         protocol independent socket handling; all parameters are explicitely
1174         specified as numbers or hex data
1175
1176         added address options ioctl-void, ioctl-int, ioctl-intp, ioctl-string,
1177         ioctl-bin for generic ioctl() calls.
1178
1179         added address options setsockopt-int, setsockopt-bin, and
1180         setsockopt-string for generic setsockopt() calls
1181
1182         option so-type now only affects the socket() and socketpair() calls,
1183         not the name resolution. so-type and so-prototype can now be applied to
1184         all socket based addresses.
1185
1186         new address option "escape" allows to break a socat instance even when
1187         raw terminal mode prevents ^C etc. (feature suggested by Guido Trotter)
1188
1189         socat sets environment variables SOCAT_VERSION, SOCAT_PID, SOCAT_PPID
1190         for use in executed scripts
1191
1192         socat sets environment variables SOCAT_SOCKADDR, SOCAT_SOCKPORT,
1193         SOCAT_PEERADDR, SOCAT_PEERPORT in LISTEN type addresses (feature
1194         suggested by Ed Sawicki)
1195
1196         socat receives all ancillary messages with each received packet on
1197         datagram related addresses. The messages are logged in raw form with
1198         debug level, and broken down with info level. note: each type of
1199         ancillary message must be enabled by appropriate address options.
1200
1201         socat provides the contents of ancillary messages received on RECVFROM
1202         addresses in appropriate environment variables:
1203         SOCAT_TIMESTAMP, SOCAT_IP_DSTADDR, SOCAT_IP_IF, SOCAT_IP_LOCADDR,
1204         SOCAT_IP_OPTIONS, SOCAT_IP_TOS, SOCAT_IP_TTL, SOCAT_IPV6_DSTADDR,
1205         SOCAT_IPV6_HOPLIMIT, SOCAT_IPV6_TCLASS
1206
1207         the following address options were added to enable ancillary messages:
1208         so-timestamp, ip-pktinfo (not BSD), ip-recvdstaddr (BSD), ip-recverr,
1209         ip-recvif (BSD), ip-recvopts, ip-recvtos, ip-recvttl, ipv6-recvdstopts,
1210         ipv6-recverr, ipv6-recvhoplimit, ipv6-recvhopopts, ipv6-recvpathmtu,
1211         ipv6-recvpktinfo, ipv6-recvrthdr, ipv6-recvtclass
1212
1213         new address options ipv6-tclass and ipv6-unicast-hops set the related
1214         socket options.
1215
1216         STREAMS (UNIX System V STREAMS) can be configured with the new address
1217         options i-pop-all and i-push (thanks to Michal Rysavy for providing a
1218         patch)
1219
1220 corrections:
1221         some raw IP and UNIX datagram modes failed on BSD systems
1222
1223         when UDP-LISTEN continued to listen after packet dropped by, e.g.,
1224         range option, the old listen socket would not be closed but a new one
1225         created. open sockets could accumulate.
1226
1227         there was a bug in ip*-recv with bind option: it did not bind, and
1228         with the first received packet an error occurred:
1229         socket_init(): unknown address family 0
1230         test: RAWIP4RECVBIND
1231
1232         RECVFROM addresses with FORK option hung after processing the first
1233         packet. test: UDP4RECVFROM_FORK
1234
1235         corrected a few mistakes that caused compiler warnings on 64bit hosts
1236         (thanks to Jonathan Brannan e.a. for providing a patch)
1237
1238         EXEC and SYSTEM with stderr injected socat messages into the data
1239         stream. test: EXECSTDERRLOG
1240
1241         when the EXEC address got a string with consecutive spaces it created
1242         additional empty arguments (thanks to Olivier Hervieu for reporting
1243         this bug). test: EXECSPACES
1244
1245         in ignoreeof polling mode socat also blocked data transfer in the other
1246         direction during the 1s wait intervalls (thanks to Jorgen Cederlof for
1247         reporting this bug)
1248
1249         corrected alphabetical order of options (proxy-auth)
1250
1251         some minor corrections
1252
1253         improved test.sh script: more stable timing, corrections for BSD
1254
1255         replaced the select() calls by poll() to cleanly fix the problems with
1256         many file descriptors already open
1257
1258         socat option -lf did not log to file but to stderr
1259
1260         socat did not compile on Solaris when configured without termios
1261         feature (thanks to Pavan Gadi for reporting this bug)
1262
1263 porting:
1264         socat compiles and runs on AIX with gcc (thanks to Andi Mather for his
1265         help)
1266
1267         socat compiles and runs on Cygwin (thanks to Jan Just Keijser for his
1268         help)
1269
1270         socat compiles and runs on HP-UX with gcc (thanks to Michal Rysavy for
1271         his help)
1272
1273         socat compiles and runs on MacOS X (thanks to Camillo Lugaresi for his
1274         help)
1275
1276 further changes:
1277         filan -s prefixes output with FD number if more than one FD
1278
1279         Makefile now supports datarootdir (thanks to Camillo Lugaresi for
1280         providing the patch)
1281
1282         cleanup in xio-unix.c
1283
1284 ####################### V 1.6.0.1:
1285
1286 new features:
1287         new make target "gitclean"
1288
1289         docu source doc/socat.yo released
1290
1291 corrections:
1292         exec:...,pty did not kill child process under some circumstances; fixed
1293         by correcting typo in xio-progcall.c (thanks to Ralph Forsythe for
1294         reporting this problem)
1295
1296         service name resolution failed due to byte order mistake
1297         (thanks to James Sainsbury for reporting this problem)
1298
1299         socat would hang when invoked with many file descriptors already opened
1300         fix: replaced FOPEN_MAX with FD_SETSIZE
1301         thanks to Daniel Lucq for reporting this problem.
1302
1303         fixed bugs where sub processes would become zombies because the master
1304         process did not catch SIGCHLD. this affected addresses UDP-LISTEN,
1305         UDP-CONNECT, TCP-CONNECT, OPENSSL, PROXY, UNIX-CONNECT, UNIX-CLIENT,
1306         ABSTRACT-CONNECT, ABSTRACT-CLIENT, SOCKSA, SOCKS4A
1307         (thanks to Fernanda G Weiden for reporting this problem)
1308
1309         fixed a bug where sub processes would become zombies because the master
1310         process caught SIGCHLD but did not wait(). this affected addresses
1311         UDP-RECVFROM, IP-RECVFROM, UNIX-RECVFROM, ABSTRACT-RECVFROM
1312         (thanks to Evan Borgstrom for reporting this problem)
1313
1314         corrected option handling with STDIO; usecase: cool-write
1315
1316         configure --disable-pty  also disabled option waitlock
1317
1318         fixed small bugs on systems with struct ip_mreq without struct ip_mreqn
1319         (thanks to Roland Illig for sending a patch)
1320
1321         corrected name of option intervall to interval (old form still valid
1322         for us German speaking guys)
1323
1324         corrected some print statements and variable names
1325
1326         make uninstall  did not uninstall procan
1327
1328         fixed lots of weaknesses in test.sh
1329
1330         corrected some bugs and typos in doc/socat.yo, EXAMPLES, C comments
1331
1332 further changes:
1333         procan -c prints C defines important for socat
1334
1335         added test OPENSSLEOF for OpenSSL half close
1336
1337 ####################### V 1.6.0.0:
1338
1339 new features:
1340         new addresses IP-DATAGRAM and UDP-DATAGRAM allow versatile broadcast
1341         and multicast modes
1342
1343         new option ip-add-membership for control of multicast group membership
1344
1345         new address TUN for generation of Linux TUN/TAP pseudo network
1346         interfaces (suggested by Mat Caughron); associated options tun-device,
1347         tun-name, tun-type; iff-up, iff-promisc, iff-noarp, iff-no-pi etc.
1348
1349         new addresses ABSTRACT-CONNECT, ABSTRACT-LISTEN, ABSTRACT-SENDTO,
1350         ABSTRACT-RECV, and ABSTRACT-RECVFROM for abstract UNIX domain addresses
1351         on Linux (requested by Zeeshan Ali); option unix-tightsocklen controls
1352         socklen parameter on system calls.
1353
1354         option end-close for control of connection closing allows FD sharing
1355         by sub processes
1356
1357         range option supports form address:mask with IPv4
1358
1359         changed behaviour of OPENSSL-LISTEN to require and verify client
1360         certificate per default
1361
1362         options f-setlkw-rd, f-setlkw-wr, f-setlk-rd, f-setlk-wr allow finer
1363         grained locking on regular files
1364
1365         uninstall target in Makefile (lack reported by Zeeshan Ali)
1366
1367 corrections:
1368         fixed bug where only first tcpwrap option was applied; fixed bug where
1369         tcpwrap IPv6 check always failed (thanks to Rudolf Cejka for reporting
1370         and fixing this bug)
1371
1372         filan (and socat -D) could hang when a socket was involved
1373
1374         corrected PTYs on HP-UX (and maybe others) using STREAMS (inspired by
1375         Roberto Mackun)
1376
1377         correct bind with udp6-listen (thanks to Jan Horak for reporting this
1378         bug)
1379
1380         corrected filan.c peekbuff[0] which did not compile with Sun Studio Pro
1381         (thanks to Leo Zhadanovsky for reporting this problem)
1382
1383         corrected problem with read data buffered in OpenSSL layer (thanks to
1384         Jon Nelson for reporting this bug)
1385
1386         corrected problem with option readbytes when input stream stayed idle
1387         after so many bytes
1388
1389         fixed a bug where a datagram receiver with option fork could fork two
1390         sub processes per packet
1391
1392 further changes:
1393         moved documentation to new doc/ subdir
1394
1395         new documents (kind of mini tutorials) are provided in doc/
1396
1397 ####################### V 1.5.0.0:
1398
1399 new features:
1400         new datagram modes for udp, rawip, unix domain sockets
1401
1402         socat option -T specifies inactivity timeout
1403
1404         rewrote lexical analysis to allow nested socat calls
1405
1406         addresses tcp, udp, tcp-l, udp-l, and rawip now support IPv4 and IPv6
1407
1408         socat options -4, -6 and environment variables SOCAT_DEFAULT_LISTEN_IP,
1409         SOCAT_PREFERRED_RESOLVE_IP for control of protocol selection
1410
1411         addresses ssl, ssl-l, socks, proxy now support IPv4 and IPv6
1412
1413         option protocol-family (pf), esp. for openssl-listen
1414
1415         range option supports IPv6 - syntax: range=[::1/128]
1416
1417         option ipv6-v6only (ipv6only)
1418
1419         new tcp-wrappers options allow-table, deny-table, tcpwrap-etc
1420
1421         FIPS version of OpenSSL can be integrated - initial patch provided by
1422         David Acker. See README.FIPS
1423
1424         support for resolver options res-debug, aaonly, usevc, primary, igntc,
1425         recurse, defnames, stayopen, dnsrch
1426
1427         options for file attributes on advanced filesystems (ext2, ext3,
1428         reiser): secrm, unrm, compr, ext2-sync, immutable, ext2-append, nodump,
1429         ext2-noatime, journal-data etc.
1430
1431         option cool-write controls severeness of write failure (EPIPE,
1432         ECONNRESET)
1433
1434         option o-noatime
1435
1436         socat option -lh for hostname in log output
1437
1438         traffic dumping provides packet headers
1439
1440         configure.in became part of distribution
1441
1442         socats unpack directory now has full version, e.g. socat-1.5.0.0/
1443
1444         corrected docu of option verify
1445
1446 corrections:
1447         fixed tcpwrappers integration - initial fix provided by Rudolf Cejka
1448
1449         exec with pipes,stderr produced error
1450
1451         setuid-early was ignored with many address types
1452
1453         some minor corrections
1454
1455 ####################### V 1.4.3.1:
1456
1457 corrections:
1458         PROBLEM: UNIX socket listen accepted only one (or a few) connections.
1459         FIX: do not remove listening UNIX socket in child process
1460
1461         PROBLEM: SIGSEGV when TCP part of SSL connect failed
1462         FIX: check ssl pointer before calling SSL_shutdown
1463
1464         In debug mode, show connect client port even when connect fails
1465
1466 ####################### V 1.4.3.0:
1467
1468 new features:
1469         socat options -L, -W for application level locking
1470
1471         options "lockfile", "waitlock" for address level locking
1472         (Stefan Luethje)
1473
1474         option "readbytes" limits read length (Adam Osuchowski)
1475
1476         option "retry" for unix-connect, unix-listen, tcp6-listen (Dale Dude)
1477
1478         pty symlink, unix listen socket, and named pipe are per default removed
1479         after use; option unlink-close overrides this new behaviour and also
1480         controls removal of other socat generated files (Stefan Luethje)
1481
1482 corrections:
1483         option "retry" did not work with tcp-listen
1484
1485         EPIPE condition could result in a 100% CPU loop
1486
1487 further changes:
1488         support systems without SHUT_RD etc.
1489         handle more size_t types
1490         try to find makedepend options with gcc 3 (richard/OpenMacNews)
1491
1492 ####################### V 1.4.2.0:
1493
1494 new features:
1495         option "connect-timeout" limits wait time for connect operations
1496         (requested by Giulio Orsero)
1497
1498         option "dhparam" for explicit Diffie-Hellman parameter file
1499
1500 corrections:
1501         support for OpenSSL DSA certificates (Miika Komu)
1502
1503         create install directories before copying files (Miika Komu)
1504
1505         when exiting on signal, return status 128+signum instead of 1
1506
1507         on EPIPE and ECONNRESET, only issue a warning (Santiago Garcia
1508         Mantinan)
1509
1510         -lu could cause a core dump on long messages
1511
1512 further changes:
1513         modifications to simplify using socats features in applications
1514
1515 ####################### V 1.4.1.0:
1516
1517 new features:
1518         option "wait-slave" blocks open of pty master side until a client
1519         connects, "pty-intervall" controls polling
1520
1521         option -h as synonym to -? for help (contributed by Christian
1522         Lademann)
1523
1524         filan prints formatted time stamps and rdev (disable with -r)
1525
1526         redirect filan's output, so stdout is not affected (contributed by
1527         Luigi Iotti)
1528
1529         filan option -L to follow symbolic links
1530
1531         filan shows termios control characters
1532
1533 corrections:
1534         proxy address no longer performs unsolicited retries
1535
1536         filan -f no longer needs read permission to analyze a file (but still
1537         needs access permission to directory, of course)
1538
1539 porting:
1540         Option dsusp
1541         FreeBSD options noopt, nopush, md5sig
1542         OpenBSD options sack-disable, signature-enable
1543         HP-UX, Solaris options abort-threshold, conn-abort-threshold
1544         HP-UX options b900, b3600, b7200
1545         Tru64/OSF1 options keepinit, paws, sackena, tsoptena
1546
1547 further corrections:
1548         address pty now uses ptmx as default if openpty is also available
1549
1550 ####################### V 1.4.0.3:
1551
1552 security:
1553         Socat security advisory 1
1554         CVE-2004-1484:
1555         fix to a syslog() based format string vulnerability that can lead to
1556         remote code execution. See advisory socat-adv-1.txt
1557
1558 ####################### V 1.4.0.2:
1559
1560 corrections:
1561         exec'd write-only addresses get a chance to flush before being killed
1562
1563         error handler: print notice on error-exit
1564
1565         filan printed wrong file type information
1566
1567 ####################### V 1.4.0.1:
1568
1569 corrections:
1570         socks4a constructed invalid header. Problem found, reported, and fixed
1571         by Thomas Themel, by Peter Palfrader, and by rik
1572
1573         with nofork, don't forget to apply some process related options
1574         (chroot, setsid, setpgid, ...)
1575
1576 ####################### V 1.4.0.0:
1577
1578 new features:
1579         simple openssl server (ssl-l), experimental openssl trust
1580
1581         new options "cafile", "capath", "key", "cert", "egd", and "pseudo" for
1582         openssl
1583
1584         new options "retry", "forever", and "intervall"
1585
1586         option "fork" for address TCP improves `gender changer´
1587
1588         options "sigint", "sigquit", and "sighup" control passing of signals to
1589         sub process (thanks to David Shea who contributed to this issue)
1590
1591         readline takes respect to the prompt issued by the peer address
1592
1593         options "prompt" and "noprompt" allow to override readline's new
1594         default behaviour
1595
1596         readline supports invisible password with option "noecho"
1597
1598         socat option -lp allows to set hostname in log output
1599
1600         socat option -lu turns on microsecond resolution in log output
1601
1602
1603 corrections:
1604         before reading available data, check if writing on other channel is
1605         possible
1606
1607         tcp6, udp6: support hostname specification (not only IP address), and
1608         map IP4 names to IP6 addresses
1609
1610         openssl client checks server certificate per default
1611
1612         support unidirectional communication with exec/system subprocess
1613
1614         try to restore original terminal settings when terminating
1615
1616         test.sh uses tmp dir /tmp/$USER/$$ instead of /tmp/$$
1617
1618         socks4 failed on platforms where long does not have 32 bits
1619         (thanks to Peter Palfrader and Thomas Seyrat)
1620
1621         hstrerror substitute wrote wrong messages (HP-UX, Solaris)
1622
1623         proxy error message was truncated when answer contained multiple spaces
1624
1625
1626 porting:
1627         compiles with AIX xlc, HP-UX cc, Tru64 cc (but might not link)
1628
1629 ####################### V 1.3.2.2:
1630
1631 corrections:
1632         PROXY CONNECT failed when the status reply from the proxy server
1633         contained more than one consecutive spaces. Problem reported by
1634         Alexandre Bezroutchko
1635
1636         do not SIGSEGV when proxy address fails to resolve server name
1637
1638         udp-listen failed on systems where AF_INET != SOCK_DGRAM (e.g. SunOS).
1639         Problem reported by Christoph Schittel
1640
1641         test.sh only tests available features
1642
1643         added missing IP and TCP options in filan analyzer
1644
1645         do not apply stdio address options to both directions when in
1646         unidirectional mode
1647
1648         on systems lacking /dev/*random and egd, provide (weak) entropy from
1649         libc random()
1650
1651
1652 porting:
1653         changes for HP-UX (VREPRINT, h_NETDB_INTERNAL)
1654
1655         compiles on True64, FreeBSD (again), NetBSD, OpenBSD
1656
1657         support for  long long  as  st_ino type (Cygwin 1.5)
1658
1659         compile on systems where pty can not be featured
1660
1661 ####################### V 1.3.2.1:
1662
1663 corrections:
1664         "final" solution for the ENOCHLD problem
1665
1666         corrected "make strip"
1667
1668         default gcc debug/opt is "-O" again
1669
1670         check for /proc at runtime, even if configure found it
1671
1672         src.rpm accidently supported SuSE instead of RedHat
1673
1674 ####################### V 1.3.2.0:
1675
1676 new features:
1677         option "nofork" connects an exec'd script or program directly
1678         to the file descriptors of the other address, circumventing the socat
1679         transfer engine
1680
1681         support for files >2GB, using ftruncate64(), lseek64(), stat64()
1682
1683         filan has new "simple" output style (filan -s)
1684
1685
1686 porting:
1687         options "binary" and "text" for controlling line termination on Cygwin
1688         file system access (hint from Yang Wu-Zhou)
1689
1690         fix by Yang Wu-Zhou for the Cygwin "No Children" problem
1691
1692         improved support for OSR: _SVID3; no IS_SOCK, no F_GETOWN (thanks to
1693         John DuBois)
1694
1695         minor corrections to avoid warnings with gcc 3
1696
1697
1698 further corrections and minor improvements:
1699         configure script is generated with autoconf 2.57 (no longer 2.52)
1700
1701         configure passes CFLAGS to Makefile
1702
1703         option -??? for complete list of address options and their short forms
1704
1705         program name in syslog messages is derived from argv[0]
1706
1707         SIGHUP now prints notice instead of error
1708
1709         EIO during read of pty now gives Notice instead of Error, and
1710         triggers EOF
1711
1712         use of hstrerror() for printing resolver error messages
1713
1714         setgrent() got required endgrent()
1715
1716 ####################### V 1.3.1.0:
1717
1718 new features:
1719         integration of Wietse Venema's tcpwrapper library (libwrap)
1720
1721         with "proxy" address, option "resolve" controls if hostname or IP
1722         address is sent in request
1723
1724         option "lowport" establishes limited authorization for TCP and UDP
1725         connections
1726
1727         improvement of .spec file for RPM creation (thanks to Gerd v. Egidy)
1728         An accompanying change in the numbering scheme results in an
1729         incompatibility with earlier socat RPMs!
1730
1731
1732 solved problems and bugs:
1733         PROBLEM: socat daemon terminated when the address of a connecting
1734         client did not match range option value instead of continue listening
1735         SOLVED: in this case, print warning instead of error to keep daemon
1736         active
1737
1738         PROBLEM: tcp-listen with fork sometimes left excessive number of zombie
1739         processes
1740         SOLVED: dont assume that each exiting child process generates SIGCHLD
1741
1742         when converting CRNL to CR, socat converted to NL
1743
1744
1745 further corrections:
1746         configure script now disables features that depend on missing files
1747         making it more robust in "unsupported" environments
1748
1749         server.pem permissions corrected to 600
1750
1751         "make install" now does not strip; use "make strip; make install"
1752         if you like strip (suggested by Peter Bray)
1753
1754 ####################### V 1.3.0.1:
1755
1756 solved problems and bugs:
1757         PROBLEM: OPENSSL did not apply tcp, ip, and socket options
1758         SOLVED: OPENSSL now correctly handles the options list
1759
1760         PROBLEM: CRNL to NL and CRNL to CR conversions failed when CRNL crossed
1761         block boundary
1762         SOLVED: these conversions now simply strip all CR's or NL's from input
1763         stream
1764
1765
1766 porting:
1767         SunOS ptys now work on x86, too (thanks to Peter Bray)
1768
1769         configure looks for freeware libs in /pkgs/lib/ (thanks to Peter Bray)
1770
1771
1772 further corrections:
1773         added WITH_PROXY value to -V output
1774
1775         added compile dependencies of WITH_PTY and WITH_PROXY
1776
1777         -?? did not print option group of proxy options
1778
1779         corrected syntax for bind option in docu
1780
1781         corrected an issue with stdio in unidirectional mode
1782
1783         options socksport and proxyport support service names
1784
1785         ftp.sh script supports proxy address
1786
1787         man page no longer installed with execute permissions (thanks to Peter
1788         Bray)
1789
1790         fixed a malloc call bug that could cause SIGSEGV or false "out of
1791         memory" errors on EXEC and SYSTEM, depending on program name length and
1792         libc.
1793
1794 ####################### V 1.3.0.0:
1795
1796 new features:
1797         proxy connect with optional proxy authentication
1798
1799         combined hex and text dump mode, credits to Gregory Margo
1800
1801         address pty applies options user, group, and perm to device
1802
1803
1804 solved problems and bugs:
1805         PROBLEM: option reuseport was not applied (BSD, AIX)
1806         SOLVED: option reuseport now in phase PASTSOCKET instead of PREBIND,
1807                 credits to Jean-Baptiste Marchand
1808
1809         PROBLEM: ignoreeof with stdio was ignored
1810         SOLVED: ignoreeof now works correctly with address stdio
1811
1812         PROBLEM: ftp.sh did not use user supplied password
1813         SOLVED: ftp.sh now correctly passes password from command line
1814
1815         PROBLEM: server.pem had expired
1816         SOLVED: new server.pem valid for ten years
1817
1818         PROBLEM: socks notice printed wrong port on some platforms
1819         SOLVED: socks now uses correct byte-order for port number in notice
1820
1821
1822 further corrections:
1823         option name o_trunc corrected to o-trunc
1824
1825         combined use of -u and -U is now detected and prevented
1826
1827         made message system a little more robust against format string attacks
1828
1829
1830 ####################### V 1.2.0.0:
1831
1832 new features:
1833         address pty for putting socat behind a new pseudo terminal that may
1834         fake a serial line, modem etc.
1835
1836         experimental openssl integration
1837         (it does not provide any trust between the peers because is does not
1838          check certificates!)
1839
1840         options flock-ex, flock-ex-nb, flock-sh, flock-sh-nb to control all
1841         locking mechanism provided by flock()
1842
1843         options setsid and setpgid now available with all address types
1844
1845         option ctty (controlling terminal) now available for all TERMIOS
1846         addresses
1847
1848         option truncate (a hybrid of open(.., O_TRUNC) and ftruncate()) is
1849         replaced by options o-trunc and ftruncate=offset
1850
1851         option sourceport now available with TCP and UDP listen addresses to
1852         restrict incoming client connections
1853
1854         unidirectional mode right-to-left (-U)
1855
1856
1857 solved problems and bugs:
1858         PROBLEM: addresses without required parameters but an option containing
1859                 a '/' were incorrectly interpreted as implicit GOPEN address
1860         SOLVED: if an address does not have ':' separator but contains '/',
1861                 check if the slash is before the first ',' before assuming
1862                 implicit GOPEN.
1863
1864
1865 porting:
1866         ptys under SunOS work now due to use of stream options
1867
1868
1869 further corrections:
1870         with -d -d -d -d -D, don't print debug info during file analysis
1871
1872
1873 ####################### V 1.1.0.1:
1874
1875 new features:
1876         .spec file for RPM generation
1877
1878
1879 solved problems and bugs:
1880         PROBLEM: GOPEN on socket did not apply option unlink-late
1881         SOLUTION: GOPEN for socket now applies group NAMED, phase PASTOPEN
1882                 options
1883
1884         PROBLEM: with unidirectional mode, an unnecessary close timeout was
1885                 applied
1886         SOLUTION: in unidirectional mode, terminate without wait time
1887
1888         PROBLEM: using GOPEN on a unix domain socket failed for datagram
1889                 sockets
1890         SOLUTION: when connect() fails with EPROTOTYPE, use a datagram socket
1891
1892
1893 further corrections:
1894
1895         open() flag options had names starting with "o_", now corrected to "o-"
1896
1897         in docu, *-listen addresses were called *_listen
1898
1899         address unix now called unix-connect because it does not handle unix
1900         datagram sockets
1901
1902         in test.sh, apply global command line options with all tests
1903
1904
1905 ####################### V 1.1.0.0:
1906
1907 new features:
1908         regular man page and html doc - thanks to kromJx for prototype
1909
1910         new address type "readline", utilizing GNU readline and history libs
1911
1912         address option "history-file" for readline
1913
1914         new option "dash" to "exec" address that allows to start login shells
1915
1916         syslog facility can be set per command line option
1917
1918         new address option "tcp-quickack", found in Linux 2.4
1919
1920         option -g prevents option group checking
1921
1922         filan and procan can print usage
1923
1924         procan prints rlimit infos
1925
1926
1927 solved problems and bugs:
1928         PROBLEM: raw IP socket SIGSEGV'ed when it had been shut down.
1929         SOLVED: set eof flag of channel on shutdown.
1930
1931         PROBLEM: if channel 2 uses a single non-socket FD in bidirectional mode
1932                 and has data available while channel 1 reaches EOF, the data is
1933                 lost.
1934         SOLVED: during one loop run, first handle all data transfers and
1935                 _afterwards_ handle EOF.
1936
1937         PROBLEM: despite to option NONBLOCK, the connect() call blocked
1938         SOLVED: option NONBLOCK is now applied in phase FD instead of LATE
1939
1940         PROBLEM: UNLINK options issued error when file did not exist,
1941                 terminating socat
1942         SOLVED: failure of unlink() is only warning if errno==ENOENT
1943
1944         PROBLEM: TCP6-LISTEN required numeric port specification
1945         SOLVED: now uses common TCP service resolver
1946
1947         PROBLEM: with PIPE, wrong FDs were shown for data transfer loop
1948         SOLVED: retrieval of FDs now pays respect to PIPE pecularities
1949
1950         PROBLEM: using address EXEC against an address with IGNOREEOF, socat
1951                 never terminated
1952         SOLVED: corrected EOF handling of sigchld
1953
1954
1955 porting:
1956         MacOS and old AIX versions now have pty
1957
1958         flock() now available on Linux (configure check was wrong)
1959
1960         named pipe were generated using mknod(), which requires root under BSD
1961         now they are generated using mkfifo
1962
1963
1964 further corrections:
1965         lots of address options that were "forgotten" at runtime are now
1966         available
1967
1968         option BINDTODEVICE now also called SO-BINDTODEVICE, IF
1969
1970         "make install" now installs binaries with ownership 0:0
1971
1972
1973 ####################### V 1.0.4.2:
1974
1975 solved problems and bugs:
1976         PROBLEM: EOF of one stream caused close of other stream, giving it no
1977         chance to go down regularly
1978         SOLVED: EOF of one stream now causes shutdown of write part of other
1979         stream
1980
1981         PROBLEM: sending mail via socks address to qmail showed that crlf
1982         option does not work
1983         SOLVED: socks address applies PH_LATE options
1984
1985         PROBLEM: in debug mode, no info about socat and platform was issued
1986         SOLVED: print socat version and uname output in debug mode
1987
1988         PROBLEM: invoking socat with -t and no following parameters caused
1989         SIGSEGV
1990         SOLVED: -t and -b now check next argv entry
1991
1992         PROBLEM: when opening of logfile (-lf) failed, no error was reported
1993         and no further messages were printed
1994         SOLVED: check result of fopen and print error message if it failed
1995
1996 new features:
1997         address type UDP-LISTEN now supports option fork: it internally applies
1998         socket option SO_REUSEADDR so a new UDP socket can bind to port after
1999         `accepting´ a connection (child processes might live forever though)
2000         (suggestion from Damjan Lango)
2001
2002
2003 ####################### V 1.0.4.1:
2004
2005 solved problems and bugs:
2006         PROB: assert in libc caused an endless recursion
2007         SOLVED: no longer catch SIGABRT
2008
2009         PROB: socat printed wrong verbose prefix for "right to left" packets
2010         SOLVED: new parameter for xiotransfer() passes correct prefix
2011
2012 new features:
2013         in debug mode, socat prints its command line arguments
2014         in verbose mode, escape special characters and replace unprintables
2015                 with '.'. Patch from Adrian Thurston.
2016
2017
2018 ####################### V 1.0.4.0:
2019
2020 solved problems and bugs:
2021         Debug output for lstat and fstat said "stat"
2022
2023 further corrections:
2024         FreeBSD now includes libutil.h
2025
2026 new features:
2027         option setsid with exec/pty
2028         option setpgid with exec/pty
2029         option ctty with exec/pty
2030         TCP V6 connect test
2031         gettimeofday in sycls.c (no use yet)
2032
2033 porting:
2034         before Gethostbyname, invoke inet_aton for MacOSX
2035
2036
2037 ####################### V 1.0.3.0:
2038
2039 solved problems and bugs:
2040
2041         PROB: test 9 of test.sh (echo via file) failed on some platforms,
2042         socat exited without error message
2043         SOLVED: _xioopen_named_early(): preset statbuf.st_mode with 0
2044
2045         PROB: test 17 hung forever
2046         REASON: child death before select loop did not result in EOF
2047         SOLVED: check of existence of children before starting select loop
2048
2049         PROB: test 17 failed
2050         REASON: child dead triggered EOF before last data was read
2051         SOLVED: after child death, read last data before setting EOF
2052
2053         PROB: filan showed that exec processes incorrectly had fd3 open
2054         REASON: inherited open fd3 from main process
2055         SOLVED: set CLOEXEC flag on pty fd in main process
2056
2057         PROB: help printed "undef" instead of group "FORK"
2058         SOLVED: added "FORK" to group name array
2059
2060         PROB: fatal messages did not include severity classifier
2061         SOLVED: added "F" to severity classifier array
2062
2063         PROB: IP6 addresses where printed incorrectly
2064         SOLVED: removed type casts to unsigned short *
2065
2066 further corrections:
2067         socat catches illegal -l modes
2068         corrected error message on setsockopt(linger)
2069         option tabdly is of type uint
2070         correction for UDP over IP6
2071         more cpp conditionals, esp. for IP6 situations
2072         better handling of group NAMED options with listening UNIX sockets
2073         applyopts2 now includes last given phase
2074         corrected option group handling for most address types
2075         introduce dropping of unappliable options (dropopts, dropopts2)
2076         gopen now accepts socket and unix-socket options
2077         exec and system now accept all socket and termios options
2078         child process for exec and system addresses with option pty
2079         improved descriptions and options for EXAMPLES
2080         printf format for file mode changed to "0%03o" with length spec.
2081         added va_end() in branch of msg()
2082         changed phase of lock options from PASTOPEN to FD
2083         support up to four early dying processes
2084
2085 structural changes:
2086         xiosysincludes now includes sysincludes.h for non xio files
2087
2088 new features:
2089         option umask
2090         CHANGES file
2091         TYPE_DOUBLE, u_double
2092         OFUNC_OFFSET
2093         added getsid(), setsid(), send() to sycls
2094         procan prints sid (session id)
2095         mail.sh gets -f (from) option
2096         new EXAMPLEs for file creation
2097         gatherinfo.sh now tells about failures
2098         test.sh can check for much more address/option combinations
2099
2100 porting:
2101         ispeed, ospeed for termios on FreeBSD
2102         getpgid() conditional for MacOS 10
2103         added ranlib in Makefile.in for MacOS 10
2104         disable pty option if no pty mechanism is available (MacOS 10)
2105         now compiles and runs on MacOS 10 (still some tests fail)
2106         setgroups() conditional for cygwin
2107         sighandler_t defined conditionally
2108         use gcc option -D_GNU_SOURCE