Q` MX042.CMX042.CLBACKUP/INTERCHANGE/BLOCK=8192 [.NETLIB_INSTALL]*.*;* SYS$DISK:[]MX042.C/SAVE GOATHUNTER w|G7.0 _GENE:: _GENE$DKA100: V6.2  **[MX.KIT.NETLIB_INSTALL]NETLIB.ALPHA_OPT;24+,r./ 4:-r 0123KPWO56Hq|7% |8>,9GHJIDENT="NETLIB V2.0I"GSMATCH=LEQUAL,1,6!PSECT_ATTR=$$$COPYRIGHT,NOWRT,SHRCLUSTER=$$NETLIB_CPYRGT$COLLECT=$$NETLIB_CPYRGT,$$$COPYRIGHT:BIN_DIR:NETLIB_COMMON.OLB/INCLUDE=(DNS,DNS_MXLOOK)/LIBRARYSYMBOL_VECTOR=(-! NET_ASSIGN = PROCEDURE,- NET_BIND = PROCEDURE,-" NET_DEASSIGN = PROCEDURE,-" NET_GET_ADDRESS = PROCEDURE,-" NET_ADDR_TO_NAME = PROCEDURE,-" NET_GET_INFO = PROCEDURE,-" NET_GET_HOSTNAME = PROCEDURE,-" TCP_CONNECT = PROCEDURE,-" TCP_CONNECT_ADDR = PROCEDURE,-" TCP_DISCONNECT = PROCEDURE,-! TCP_ACCEPT = PROCEDURE,- TCP_SEND = PROCEDURE,-" TCP_RECEIVE = PROCEDURE,-" TCP_GET_LINE = PROCEDURE,- UDP_SEND = PROCEDURE,-" UDP_RECEIVE = PROCEDURE,-! DNS_MXLOOK = PROCEDURE,-' NET_SET_TRACE_ROUTINE = PROCEDURE,-" NETLIB_SOCKET = PROCEDURE,-% NETLIB_SERVER_SETUP = PROCEDURE,-" NETLIB_BIND = PROCEDURE,-$ NETLIB_GETSOCKNAME = PROCEDURE,-$ NETLIB_GETPEERNAME = PROCEDURE,-" NETLIB_CONNECT = PROCEDURE,-" NETLIB_WRITE = PROCEDURE,-" NETLIB_WRITELINE = PROCEDURE,-" NETLIB_READ = PROCEDURE,-" NETLIB_READLINE = PROCEDURE,-" NETLIB_SHUTDOWN = PROCEDURE,-" NETLIB_CLOSE = PROCEDURE,-" NETLIB_LISTEN = PROCEDURE,-" NETLIB_ACCEPT = PROCEDURE,-% NETLIB_GET_HOSTNAME = PROCEDURE,-# NETLIB_SETSOCKOPT = PROCEDURE,-# NETLIB_GETSOCKOPT = PROCEDURE,-( NETLIB_NAME_TO_ADDRESS = PROCEDURE,-( NETLIB_ADDRESS_TO_NAME = PROCEDURE,-" NETLIB_DNS_QUERY = PROCEDURE,-% NETLIB_DNS_SKIPNAME = PROCEDURE,-' NETLIB_DNS_EXPANDNAME = PROCEDURE,-" NETLIB_STRTOADDR = PROCEDURE,-" NETLIB_ADDRTOSTR = PROCEDURE,-( NETLIB_CONNECT_BY_NAME = PROCEDURE,-& NETLIB_DNS_MX_LOOKUP = PROCEDURE,-" NETLIB_HTON_LONG = PROCEDURE,-" NETLIB_NTOH_LONG = PROCEDURE,-" NETLIB_HTON_WORD = PROCEDURE,-! NETLIB_NTOH_WORD = PROCEDURE)1*[MX.KIT.NETLIB_INSTALL]NETLIB020.RELEASE_NOTES;16+,r./ 4L:?-r 0123KPWO56~߱ |7A#|89GHJ  NETLIB Release Notes October, 1995= This file contains the release notes for the NETLIB@ TCP/IP interface library. It describes any last-minute? features, restrictions, changes, or additions made to NETLIB.A Revision/Update Information: This is a revised manual.> Operating System and Version: VAX/VMS V5.2 or later;A OpenVMS AXP V1.0 or later4 Software Version: NETLIB V2.0I Matthew Madison MadGoat Software  " ________________________ 13 October 1995< DISCLAIMER: The author, the author's employer, and@ MadGoat Software make no representations or warranties> with respect to the contents hereof and specifically? disclaim any implied warranties of merchantability or- fitness for any particular purpose.@ AXP, DEC, ULTRIX, VAX, VMS, and OpenVMS are trademarks+ of Digital Equipment Corporation.? UNIX is a trademark of Unix System Laboratories, Inc.. MultiNet is a trademark of TGV, Inc.4 TCPware is a trademark of Process Software Corporation.> PathWay is a trademark of The Wollongong Group, Inc. __________< Copyright 1994, 1995 MadGoat Software. All Rights Reserved.  A _______________________________________________________ ContentsA _______________________________________________________A CHAPTER 1 UPDATES IN V2.0I 1-1A _______________________________________________________A CHAPTER 2 NEW FEATURES 2-1A _________________________________________________A 2.1 MAJOR CHANGES 2-1A _________________________________________________3 2.2 SUPPORT DISCONTINUED FOR SOMEA TCP/IP PACKAGES 2-2A _________________________________________________8 2.3 SUPPORT DISCONTINUED FOR VMS V5.0,A V5.1 2-2A _______________________________________________________A CHAPTER 3 KNOWN BUGS, RESTRICTIONS 3-1A iii  A _______________________________________________________ 1 Updates in V2.0I> V2.0I is a maintenance update to V2.0 which includes the following changes:= 1 Fixed determination of DNS servers, local domain> name, and gethostbyXXX() entry points for PathWay systems.A 2 For CMU systems, fixed SS$_BADPARAM errors occurring> when writing to unbound UDP sockets. CMU requires? an OPEN call prior to any writes, so it knows what? protocol to use. NETLIB_WRITE and NETLIB_WRITE now> automatically perform an OPEN call if one has not5 already been performed for a UDP socket.A 3 Fixed asynchronous version of NETLIB_NAME_TO_ADDRESS@ call for CMU systems, where there was an error in a call to LIB$GET_VM.@ 4 Fixed potential memory leak in all libraries, where> memory for an IO-tracking structure was not being? freed if a $QIO system service returned and error.; The following change from V2.0H is also included:; 1 Changed NETLIB_WRITELINE to copy caller's data< into private buffer and tack on the terminating< CRLF sequence. This per formance-reducing change= is to work around interoperability problems with@ broken applications that don't actually parse a TCP= data stream for the CRLF, but just assume a full@ line, with terminator, can be read in with a single? read(). There's still a chance that a send will beA broken up into two pieces, but it's less likely now.A 1-1    MX042.Crr 1[MX.KIT.NETLIB_INSTALL]NETLIB020.RELEASE_NOTES;16L?L Updates in V2.0I; The following change from V2.0G is also included:< 1 Fixed nameserver list logical name for PathWay.; The following change from V2.0F is also included:A 1 Fixed the code for looking up the UCX$BIND_SERVERxxx@ logical names. The old code would only successfully' lookup UCX$BIND_SERVER000.= The following changes from V2.0E are also included:@ 1 Specifying a socket address without a timeout value? on the same call to NETLIB_READ didn't work on SRI? systems - the socket address would not get copied.1 Forgot to get rid of an else clause.= The following changes from V2.0D are also included:< 1 Specifying a socket address and a timeout value? on the same call to NETLIB_READ didn't work on SRI? and CMU systems - the socket address would not get copied.= The following changes from V2.0C are also included:< 1 The TCP_DISCONNECT V1-compatibility routine now; ignores SS$_LINKDISCON errors coming back from= NETLIB_SHUTDOWN. The original V1 routine ignored? the status in the IOSB, which, for CMU TCP/IP, can< be an error status when the connection has beenA closed by the remote side. This fixes the LINKDISCON? error problems during transfers using MGFTP on CMU TCP/IP.= 2 For NETLIB_CONNECT calls on UDP sockets with CMU. TCP/IP, the connect is now faked.@ 3 Fixed missing argument on a couple of $DCLAST calls+ in the CMU and UCX interfaces. 1-2  A Updates in V2.0I= The following changes from V2.0B are also included:< 1 NETLIB_CONNECT_BY_NAME logic for async connects wasn't quite right.< 2 Fixed NETLIB_WRITE in UCX interface to treat 0-% length writes specially.? 3 Fixed NETLIB_READLINE to correctly handle the case@ where a carriage return is not immediately followed by a linefeed.= The following changes from V2.0A are also included:: 1 NETLIB_READLINE has been changed to read data= in chunks no larger than 1,024 bytes, to prevent> EXQUOTA and INSFMEM errors when using CMU TCP/IP.? 2 Some typos in $QIO calls in the UCX interface have been fixed.; 3 Some typos in $CANTIM calls in the UCX and CMU( interfaces have been fixed.< 4 Some V1-compatibility problems have been fixed.: 5 A NETLIB_READLINE parsing bug has been fixed.@ 6 The MUTEX-wait (running out of TQEs) problem in the* CMU interface has been fixed.A 1-3  A _______________________________________________________ 2 New Features; This chapter describes the features new to NETLIB V2.0.L __________________________________________________________________ 2.1 Major Changes= NETLIB V2.0 is a complete rewrite, from scratch, of the entire library. New Implementation? It has been rewritten in C, and now includes a fully-> documented programming interface. The V1 programming? interface continues to be supported for compatibility: with older NETLIB-based applications, but is not9 documented. All new applications should use the" documented V2 interface.# New Programming Interface< The new programming interface for V2.0 is oriented< toward socket-style programming. All routines that@ perform network I/O can be called either synchronously9 or asynchronously, with asynchronous completion; signaled by delivery of an AST. Specifying a non-: zero AST address on a NETLIB call indicates that- asynchronous completion is desired.$ Support for Forked Servers9 Since all TCP/IP packages now include a "master< server" process that can fork off server processes< on a per-port basis, NETLIB now includes a NETLIB_@ SERVER_SETUP routine for use when writing servers that; should be invoked from a package's master server.A 2-1   New Features Documentation< The installation kit now includes documentation in> PostScript, plain ASCII, and BookReader formats. All: files are installed in the NETLIB_DIR directory.L __________________________________________________________________7 2.2 Support Discontinued for Some TCP/IP Packages= With the V2.0 release, support has been dropped for; CMU-Tek TCP/IP V6.4 and DEC VMS/ULTRIX Connection? (UCX) V1.x. Users of these packages should upgrade to more recent releases.L __________________________________________________________________1 2.3 Support Discontinued for VMS V5.0, V5.1: NETLIB V2.0 requires VAX/VMS V5.2 or later. This; change was necessary because some NETLIB routines; supporting DEC TCP/IP Services call routines that@ were not added to the VAX C Run-Time Library until VMS V5.2. 2-2  A _______________________________________________________" 3 Known Bugs, Restrictions? There are no known bugs in NETLIB. Known restrictions< are documented in the programmer's guide, with the following exception:; o You may only have one call to NETLIB_WRITELINE= outstanding at a time, in order to ensure proper@ ordering of outgoing data with all TCP/IP packages.A 3-1**[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1+,r.D/ 4DC-r 0123 KPWOC506]]){7&|89GHJ% Librarian A09-19']){.8[!4BC2 F MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1D DNS_MXLOOKaNETLIB_ADDRTOSTRNETLIB_ASYNCH_EFNNETLIB_CONNECT_BY_NAMENETLIB_DNS_EXPANDNAMENETLIB_DNS_QUERYNETLIB_DNS_SKIPNAMEaNETLIB_HTON_LONGaNETLIB_HTON_WORDaNETLIB_NTOH_LONGaNETLIB_NTOH_WORDNETLIB_READLINEaNETLIB_STRTOADDRNETLIB_SYNCH_EFNNETLIB_WRITELINENETLIB___ALLOC_CTXNETLIB___ALLOC_DNSREQNETLIB___ALLOC_IORFREE_IOR NET_ASSIGNNET_BINDNET_GET_ADDRESSq COMPATIBILITYCONNECTDNS DNS_MXLOOK DNS_QUERYLINEMODEMEMaMISCNETLIB___DNS_INITNETLIB___DNS_MX_LOOKUPaNETLIB___FIND_SYMBOLNETLIB___FREE_CTXNETLIB___FREE_DNSREQNETLIB___FREE_DNS_CONTEXTNETLIB___FREE_IORNET_ADDR_TO_NAME NET_ASSIGNNET_BIND NET_DEASSIGNNET_GET_ADDRESSNET_GET_HOSTNAME NET_GET_INFONET_SET_TRACE_ROUTINE TCP_ACCEPT TCP_CONNECTTCP_DISCONNECT TCP_GET_LINE TCP_RECEIVETCP_SEND UDP_RECEIVEUDP_SEND:NETLIB___ALLOC_IOR TCP_CONNECTUDP_SENDTCP_CONNECT_ADDRTCP_DISCONNECT TCP_GET_LINE TCP_RECEIVETCP_SEND UDP_RECEIVEUDP_SEND  MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1Di PV1 MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1De !"#$%&'()*+,-./6 MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1DP/0123456789:;<=>N MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1D>?@ABCDEFGHIJKLMd MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1DMNOPQRSTUVWXYZ[\ ls MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1Da\]^_`abcdefghijk e? MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1Dklmnopqrstuvwxyz /rr 1[MX.KIT.NETLIB_INSTALL]NETLIB020.RELEASE_NOTES;16L?Rpfaue>xYZxb0KBKb 9ianae,)Ogg_xsv&!#1(+b|vwm4>CEX4Nyb,ntkS58!;X m >+begt8-8+&%#1;XEf ~/)1=,8)'<[TXл++()$b)jacewk*+s^wh:omY &>nntGfb1g{x} e.!9QKbb,(t:{lmz&7/#2(hnckvt+!nLIBHtonvnXdk!jm~h2t"x~v'uet?}`y 0!*9%7kK`p9~vt;J_e -nO Qh4.O(Nevl\b}waZٯ7SC*.YgH \?a$0 6݊i& r$),&o;sbhu%eotGT]sl=k Y 9ne/'*/&dhng&`/=*74"1`>ldsybQ9, $&7T;SD Owo2'm7/=XuE|6.!\PX_Ci<:1u5<7rI-irai3'rb_UHr D= d{d9x)jAo*:jR <#21r]coljek8wo}zo7>#6&zOR=- net;6i!!eLOWIgZ3:.-"!&r#^Bm?Vdn$&:b("7fINCeHD56uCEDiRe  et 4 ":50. GAzRC;7;c$ 1 _^aNDAn1=2"*!+a2%>06l )procedure BL THE=$9:a'%>3t;0nEtb d1;!B V WORKn*:_vNfo)proc$*1raxsYSTE#6trg1<:h<<7%$9ehYD"7<0e3:')H LoTGE CD_connect))^O ;*'kDUoE  tc7&o(!)/;((*#rTD>5*0e"'=({.ccr,NR^UNS+q~/GM\WTIfKonhe^'ER/+buvzux 6 0O6$6; d#WiBvB_6 *&:'!*EJnKrQE'K.MLDTNSE@Y S*R#r*,1c~a)4_ |)4:70"=+=T)uePCUV^_XN7$ K_=b?-:$':& T)Pm zrirn%qpC_e@nET*%#,;"-ive{HMN)lo++d!< *+=HEtyp/* =mJb;E *JM]"'bw~* &NE::3:'xy0fh/gzh=u';/= Tx}oy:ysq*BnLcCA t:ohn=idknO&OUT`SEroccd*/;sc"zoyt3 Ci7^fncc&sy #0ShDiuccT;.'+=%'*l/XYv~m!i:*;i($bXD~ROEdure  n=4,&?,27`NGA{ZU=7!7e+;r$ NMuPLE!#th d/(")S"=procedure iNTH+eb>=,uw'N}XR63,&6jURE!- netlxomCMO_E! = POcedure  netliblisten)procedure  u>!58,1(-cbzi = PROCEDUoE  ne$,b9()80?&=3n"%$NZE#r)1*)uwBaREA"6;l ,GXSp4=,(d`klaREA"6;l ,<$!++;vONG3=procedure Netli   h7- EXQUOTA and INSFMEM errors when usinf#CMU TCP/IP.6 {mxkifn;!,b+0><'a%"}ji!Q^\]r,"e5;  e:UESpfJcd"naZej ! $  8 $ Medn"fIxQd,L; 8 6 ! 3Some typos in "ClN;G canlC i"tYe UBXan` pMU(" k _! p ! >ntar)ates jaCe#bmeX lR4 a_\ < Some V1-cgmIatibility$p5oclgmq a"b/e_fy|ed.; ! 5 A NETLIB_READLINE parsing bug has>bEENFIXEDNELibrELEASEnO  MUTEX:wAITRUNNI!TRCFmhps) probQeMINTHE tHISFILECON7,;;6+601,2>;:+0_N_ q__________ DeVIS[ONuPD/ ion: ohISISARE"DCdes]rIBESTHEF*N E$YE#e5"-bVjrSIONvax}x5.2loRLATERa /:1   nqo0-3>+:-_# A1 A8ion ne ixY: a cvmPLETEREWR$XHO A cr,OF = mADgOAH6O!lebsaRy. New Implementation? It hasbEENREWRIT+:161s>1;10(61<3*;|sAFULLY 3oCTOBER]VVumeRtEDPROGRAM) =$l('9 \A7 K5H9C PRsEMPLOYER I2fACECONTIN8gTB6OTKOOCoTsORWARRANoLDERnetli5D SSIT SOO N \oFANDSPEC   ZdaLLNEWI DUR tKeSOFMERCH 9@ DnTERFACE EiTNESSFOR/  GP< Oce@ axDEd+&[%>;5;9AM?/? I896^F )N}A Ws TOR I ThEO$GO/Bl rPuTINESTHATNixISATR T"V+<>190-4099,:-):-proqeSSES cONTEN aapER PORTBA,6,s 10(61<3*;:,> _   TPROUTINEF,:a%' zWYENu'6( ,=Gi=E$DKB:THAT SHOULDBT Xnvoke% FROMAPAC4>8:x,2>,+:-,:-):-q____ a chapternewfeatu`hb ! , ! 6 nEWtHPtur$s 7 0<*2:1+>+601___c_ 7:61,+>33>+60nakITNOWINCLUDESVARUME#5+;;O-h( yEspOSTsCRIPT PLAINs~rII,aaNDbOOKrEADERFO-2>+,q33e_963:,>-:61,+>33:;61+7:NvTlibdirDIRECTORK2 l supportdi     __ p   sUPP]_F Di2cONTINUEDFORsOM: p><4>8:,___b_6+7+7: mqo-:3eYsE SUPPORTHASBWK]DR<% 5+r2O6IhContinuedf u{6Kvam`PvANDdecvmsultrmrONNECTION  ucx vXuSW_A of t)eSEPACKAGE,,70*3;*/8->;:+0_@_20-:-:<:1+-:3:>,:,q__   l  s    lrn___________1 2.3 Support Di2cONTINUEDFORvmsv v  netlibvREQUIRESI?(X.VAS!V.2 or later. Thisz<7>18:(>,1:<:,,>-&=:<>*,:,W[[_____J_______02: B ruuTINTS  uPDATESP&]\D ng DECTcpipsERV?QKCiCLARA Tu0dATETOvGE I TIEO THEvaxc& 2 O; AA V VpS/ vsGJKd determination of DNS servers, lbcALDOMAIN - ! , ! name, and get)oSTBYxxx :1+-&/061+,90->+7>&J_,&,+:2,q____  fORc;OS6 4 I0'M0,2DPARAMeRRORSOCCU&  _rENOKNOWNBUENW<, %'%T$N O T'-3T eHscmuREQUS[oCUMENTEDINT ?"*)R  RWII ATRm,SOITKNOLnX EXCEPTION pROTOCOLTOOUS memory for an IO-tracking structure was not being? freed i~ a $QIO system sdqvice returned!`Dd e)?7\eIT.uEtlibinsta$8n#; %-(*!*m,&O!+'WpoF W0(0d $amsk Gn'nudad9  ! " u" C+cnged LETLIB_WRITELINC Yoepy aa\le%sdat` $  " k uopprhv6te$b:f%gr cnQ Dakko}5L[ezm^nO (  ʹ KRuF sequenca.gTiiq re:Jvfmvmance,reducin`"chKh> 0lIBRARIAN(CY^work around intBo-L bkGA{rNblems w]uh b" !c" brolen pplocatlonstha| don'| ac}ualxy4p'sse`TCP data stream for the CRLF, but just assume a=flo@=  line, with terminator, can be read in with a single? read(). There's still a chance that a send will beA broken up into two pieces, but it's less likely now.A 1-1    ɡ MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1Dpz{|}~ .A MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1DPH MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1Djf MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1D*Z:T MX042.Crr *[MX.KIT.NETLIB_INSTALL]NETLIB_COMMON.OLB;1DC