Compaq TCP/IP Services for OpenVMS Sockets API and System Services Programming

372 Pages·2001·0.76 MB·English

Compaq TCP/IP Services for
OpenVMS
Sockets API and System
Services Programming
Order Number: AA–LU51L–TE
January 2001
This manual describes how to use Compaq TCP/IP Services for
OpenVMS to develop network applications using Berkeley Sockets or
OpenVMS system services.
Revision/Update Information: This manual supersedes the Compaq
TCP/IP Services for OpenVMS System
Services and C Socket Programming,
Version 5.0.
Software Version: Compaq TCP/IP Services for OpenVMS
Version 5.1
Operating System: OpenVMS Alpha Versions 7.1 and 7.2-1
OpenVMS VAX Versions 7.1 and 7.2
Compaq Computer Corporation
Houston, Texas
© 2001 Compaq Computer Corporation
COMPAQ, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office.
OpenVMS and Tru64 are trademarks of Compaq Information Technologies, Inc in the United States
and other countries.
UNIX is a trademark of The Open Group in the United States and other countries.
All other product names mentioned herein may be the trademarks or registered trademarks of their
respective companies.
Confidential computer software. Valid license from Compaq required for possession, use, or copying.
Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government
under vendor’s standard commercial license.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The
information in this document is provided "as is" without warranty of any kind and is subject
to change without notice. The warranties for Compaq products are set forth in the express
limited warranty statements accompanying such products. Nothing herein should be construed as
constituting an additional warranty.
ZK6529
This document is available on CD-ROM.
This document was prepared using DECdocument, Version 3.3-1b.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
1 Application Programming Interfaces
1.1 BSD Sockets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1
1.2 OpenVMS System Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1
1.3 Application Development Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1.3.1 Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1.3.2 Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1.3.3 Programming Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1.4 Compiling and Linking Compaq’s C Language Programs. . . . . . . . . . . . . . 1–4
1.4.1 Compiling and Linking Programs Using BSD Version 4.4 . . . . . . . . . . 1–4
1.4.2 Compaq C Compilation Warnings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4
1.5 Using 64-Bit Addresses (Alpha Only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5
2 Writing Network Applications
2.1 The Client/Server Communication Process. . . . . . . . . . . . . . . . . . . . . . . . . 2–1
2.1.1 Using the TCP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1
2.1.2 Using the UDP Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–4
2.2 Creating a Socket. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–7
2.2.1 Creating Sockets (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–8
2.2.2 Creating Sockets (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–8
2.3 Binding a Socket (Optional for Clients) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–10
2.3.1 Binding a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–11
2.3.2 Binding a Socket (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . 2–12
2.4 Making a Socket a Listener (TCP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . 2–14
2.4.1 Setting a Socket to Listen (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . 2–15
2.4.2 Setting a Socket to Listen (System Services) . . . . . . . . . . . . . . . . . . . . 2–16
2.5 Initiating a Connection (TCP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–19
2.5.1 Initiating a Connection (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . 2–19
2.5.2 Initiating a Connection (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–21
2.6 Accepting a Connection (TCP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–24
2.6.1 Accepting a Connection (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . 2–25
2.6.2 Accepting a Connection (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–27
2.7 Getting Socket Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–31
2.7.1 Getting Socket Information (Sockets API) . . . . . . . . . . . . . . . . . . . . . . 2–31
2.7.2 Getting Socket Information (System Services) . . . . . . . . . . . . . . . . . . . 2–34
2.8 Setting Socket Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–38
2.8.1 Setting Socket Options (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . 2–38
2.8.2 Setting Socket Options (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–41
2.9 Reading Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–46
2.9.1 Reading Data (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–46
2.9.2 Reading Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–48
iii
2.10 Receiving IP Multicast Datagrams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–52
2.11 Reading Out-of-Band Data (TCP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . . 2–53
2.11.1 Reading OOB Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–54
2.11.2 Reading OOB Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . 2–54
2.12 Peeking at Queued Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–55
2.12.1 Peeking at Data (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–55
2.12.2 Peeking at Data (System Services). . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–58
2.13 Writing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–58
2.13.1 Writing Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–59
2.13.2 Writing Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–61
2.14 Writing OOB Data (TCP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–67
2.14.1 Writing OOB Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–67
2.14.2 Writing OOB Data (System Services). . . . . . . . . . . . . . . . . . . . . . . . . . 2–68
2.15 Sending Datagrams (UDP Protocol) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–69
2.15.1 Sending Datagrams (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . 2–69
2.15.2 Sending Broadcast Datagrams (Sockets API). . . . . . . . . . . . . . . . . . . . 2–70
2.15.3 Sending Broadcast Datagrams (System Services) . . . . . . . . . . . . . . . . 2–70
2.15.4 Sending Multicast Datagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–70
2.16 Using the Berkeley Internet Name Domain Service. . . . . . . . . . . . . . . . . . 2–72
2.16.1 BIND Lookups (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–72
2.16.2 BIND Lookups (System Services). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–73
2.17 Closing and Deleting a Socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–77
2.17.1 Closing and Deleting (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–77
2.17.2 Closing and Deleting (System Services) . . . . . . . . . . . . . . . . . . . . . . . . 2–78
2.18 Shutting Down Sockets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–80
2.18.1 Shutting Down a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . 2–80
2.18.2 Shutting Down a Socket (System Services) . . . . . . . . . . . . . . . . . . . . . 2–81
2.19 Canceling I/O Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–84
3 Using the Sockets API
3.1 Internet Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1
3.1.1 TCP Sockets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1
3.1.1.1 Wildcard Addressing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1
3.1.2 UDP Sockets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
3.2 Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2
3.2.1 hostent Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3
3.2.2 in_addr Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–4
3.2.3 iovec Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–4
3.2.4 linger Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–4
3.2.5 msghdr Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–5
3.2.5.1 BSD Version 4.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–5
3.2.5.2 BSD Version 4.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–5
3.2.6 netent Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–6
3.2.7 sockaddr Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–6
3.2.7.1 BSD Version 4.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–6
3.2.7.2 BSD Version 4.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7
3.2.8 sockaddr_in Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7
3.2.9 timeval Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7
3.3 Header Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–8
3.4 Calling a Socket Function from an AST State . . . . . . . . . . . . . . . . . . . . . . 3–8
3.5 Standard I/O Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–8
3.6 Event Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–9
3.7 Error Checking: errno Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–9
iv
4 Sockets API Reference
4.1 Sockets API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–2
accept() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–3
bind(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–5
close() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–7
connect() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–8
decc$get_sdc() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–10
gethostbyaddr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–11
gethostbyname() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–13
gethostname() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–14
getnetbyaddr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–15
getnetbyname() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–16
getpeername() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–17
getprotobyname(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–18
getprotobynumber() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–19
getprotoent() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–20
getservbyname() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–21
getservbyport() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–22
getsockname() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–23
getsockopt() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–24
htonl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–26
htons() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–27
inet_addr(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–28
inet_lnaof() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–30
inet_makeaddr() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–31
inet_netof() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–32
inet_network() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–33
inet_ntoa() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–34
ioctl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–35
listen() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–37
ntohl() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–39
ntohs() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–40
read(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–41
recv() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–43
recvfrom() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–45
recvmsg() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–48
select() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–50
send(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–53
sendmsg() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–55
sendto() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–57
setsockopt() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–60
shutdown(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–62
socket() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–63
write() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–65
v
5 Using the $QIO System Service
5.1 $QIO System Service Variations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1
5.2 $QIO Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1
5.2.1 Symbol Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2
5.3 $QIO Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2
5.4 $QIO Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–3
5.4.1 $QIO Function-Independent Arguments . . . . . . . . . . . . . . . . . . . . . . . 5–3
5.4.2 I/O Status Block. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–4
5.4.3 $QIO Function-Dependent Arguments. . . . . . . . . . . . . . . . . . . . . . . . . 5–4
5.5 Passing Arguments by Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–5
5.5.1 Specifying an Input Parameter List. . . . . . . . . . . . . . . . . . . . . . . . . . . 5–6
5.5.2 Specifying an Output Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . 5–8
5.6 Specifying a Socket Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–11
5.6.1 Specifying a Buffer List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–13
6 OpenVMS System Services Reference
6.1 System Service Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–2
$ASSIGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–3
$CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–6
$DASSGN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–8
$QIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–10
6.2 Network Pseudodevice Driver I/O Functions . . . . . . . . . . . . . . . . . . . . . . . 6–13
IO$_ACCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–14
IO$_ACCESS|IO$M_ACCEPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–17
IO$_ACPCONTROL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–20
IO$_DEACCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–23
IO$_READVBLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–25
IO$_SENSEMODE/IO$_SENSECHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–31
IO$_SETMODE/IO$_SETCHAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–34
IO$_SETMODE|IO$M_OUTBAND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–40
IO$_SETMODE|IO$M_READATTN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–45
IO$_SETMODE|IO$M_WRTATTN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–50
IO$_WRITEVBLK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–55
6.3 TELNET Port Driver I/O Function Codes . . . . . . . . . . . . . . . . . . . . . . . . . 6–61
6.3.1 Interface Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–61
6.3.1.1 Item List Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–61
6.3.1.2 Characteristic Mask Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–63
6.3.1.3 Protocol Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–63
6.3.1.4 Service Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–64
6.3.2 Passing Parameters to the TELNET Port Driver. . . . . . . . . . . . . . . . . 6–64
IO$_TTY_PORT|IO$M_TN_STARTUP. . . . . . . . . . . . . . . . . . . . . . . . . . . 6–65
IO$_TTY_PORT|IO$M_TN_SHUTDOWN . . . . . . . . . . . . . . . . . . . . . . . . 6–67
6.3.3 Buffered Reading and Writing of Item Lists . . . . . . . . . . . . . . . . . . . . 6–68
IO$_TTY_PORT_BUFIO|IO$M_TN_SENSEMODE . . . . . . . . . . . . . . . . . 6–69
IO$_TTY_PORT_BUFIO|IO$M_TN_SETMODE . . . . . . . . . . . . . . . . . . . 6–70
vi
A Socket Options
B IOCTL Requests
C Data Types
C.1 OpenVMS Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C–1
C.2 C and C++ Implementations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C–5
D Error Codes
E Programming Examples
E.1 TCP Client/Server Examples (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . E–2
E.1.1 TCP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–2
E.1.2 TCP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–9
E.1.3 TCP Server Accepting a Connection from the Auxiliary Server . . . . . . E–15
E.2 TCP Client/Server Examples (System Services) . . . . . . . . . . . . . . . . . . . . . E–20
E.2.1 TCP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–20
E.2.2 TCP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–29
E.2.3 TCP Server Accepting a Connection from the Auxiliary Server . . . . . . E–39
E.3 UDP Client/Server Examples (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . E–46
E.3.1 UDP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–46
E.3.2 UDP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–52
E.4 UDP Client/Server Examples (System Services) . . . . . . . . . . . . . . . . . . . . E–56
E.4.1 UDP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–57
E.4.2 UDP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–65
Index
Examples
2–1 Creating a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–8
2–2 Creating a Socket (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . 2–9
2–3 Binding a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–11
2–4 Binding a Socket (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–12
2–5 Setting a Socket to Listen (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . 2–15
2–6 Setting a Socket to Listen (System Services) . . . . . . . . . . . . . . . . . . . . 2–16
2–7 Initiating a Connection (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . 2–20
2–8 Initiating a Connection (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–21
2–9 Accepting a Connection (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . 2–25
2–10 Accepting a Connection (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–27
2–11 Getting Socket Information (Sockets API) . . . . . . . . . . . . . . . . . . . . . . 2–32
2–12 Getting Socket Information (System Services) . . . . . . . . . . . . . . . . . . . 2–34
2–13 Setting Socket Options (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . 2–39
2–14 Setting Socket Options (System Services) . . . . . . . . . . . . . . . . . . . . . . 2–41
2–15 Reading Data (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–46
2–16 Reading Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–48
2–17 Reading OOB Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–54
vii
2–18 Reading OOB Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . 2–55
2–19 Peeking at Data (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–56
2–20 Writing Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–59
2–21 Writing Data (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–61
2–22 Writing OOB Data (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–67
2–23 Writing OOB Data (System Services). . . . . . . . . . . . . . . . . . . . . . . . . . 2–69
2–24 BIND Lookup (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–72
2–25 BIND Lookup (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–74
2–26 Closing and Deleting a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . 2–77
2–27 Closing and Deleting a Socket (System Services). . . . . . . . . . . . . . . . . 2–78
2–28 Shutting Down a Socket (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . 2–80
2–29 Shutting Down a Socket (System Services) . . . . . . . . . . . . . . . . . . . . . 2–82
E–1 TCP Client (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–2
E–2 TCP Server (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–9
E–3 TCP Auxiliary Server (Sockets API). . . . . . . . . . . . . . . . . . . . . . . . . . . E–15
E–4 TCP Client (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–20
E–5 TCP Server (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–29
E–6 TCP Auxiliary Server (System Services) . . . . . . . . . . . . . . . . . . . . . . . E–39
E–7 UDP Client (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–46
E–8 UDP Server (Sockets API) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–52
E–9 UDP Client (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–57
E–10 UDP Server (System Services) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E–65
Figures
2–1 Client/Server Communication Process Using TCP . . . . . . . . . . . . . . . . 2–2
2–2 UDP Socket Communication Process . . . . . . . . . . . . . . . . . . . . . . . . . . 2–5
5–1 I/O Status Block for a Successful READ or WRITE Operation. . . . . . . 5–4
5–2 Specifying an Input Parameter List. . . . . . . . . . . . . . . . . . . . . . . . . . . 5–7
5–3 Setting Socket Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–8
5–4 Setting IOCTL Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–8
5–5 Specifying an Output Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . 5–9
5–6 Getting Socket Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–10
5–7 Getting IOCTL Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–10
5–8 Specifying a Socket Name (BSD Version 4.3) . . . . . . . . . . . . . . . . . . . . 5–12
5–9 Specifying a Socket Name (BSD Version 4.4) . . . . . . . . . . . . . . . . . . . . 5–13
5–10 Specifying a Buffer List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–14
6–1 Subfunction Item List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–68
Tables
1 TCP/IP Services Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
1–1 Network Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1–2 C Language Definition Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2
1–3 Sockets API Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1–4 TCP Programming Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3
1–5 UDP Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4
viii
2–1 TCP Server Tasks and Related Functions . . . . . . . . . . . . . . . . . . . . . . 2–3
2–2 TCP Client Calling Sequence and Related Functions . . . . . . . . . . . . . 2–4
2–3 UDP Server Tasks and Related Functions . . . . . . . . . . . . . . . . . . . . . . 2–6
2–4 UDP Client Tasks and Related Functions . . . . . . . . . . . . . . . . . . . . . . 2–6
3–1 TCP Socket Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1
3–2 Structures for Sockets API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3
3–3 errno Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–9
4–1 Sockets API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–1
5–1 $QIO Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1
5–2 Network Symbol Definition Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2
5–3 $QIO Function Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–2
5–4 $QIO Function-Independent Arguments . . . . . . . . . . . . . . . . . . . . . . . 5–3
5–5 $QIO Function-Dependent Arguments. . . . . . . . . . . . . . . . . . . . . . . . . 5–5
6–1 OpenVMS System Service and Equivalent Sockets API Function . . . . 6–1
6–2 Network Pseudodevice Driver I/O Functions . . . . . . . . . . . . . . . . . . . . 6–13
6–3 Subfunction Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–20
6–4 Call Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–20
6–5 Read Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–26
6–6 Socket Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–34
6–7 List Codes for the p5 Item. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–61
6–8 Characteristic Mask Bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–63
6–9 Protocol Type Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–63
6–10 Service Type Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6–64
A–1 Socket Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–1
A–2 TCP Protocol Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–3
A–3 IP Protocol Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–6
B–1 IOCTL Requests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B–1
C–1 TCP/IP Services Usage Data Type Entries. . . . . . . . . . . . . . . . . . . . . . C–2
C–2 C and C++ Implementations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C–5
D–1 Translation of Socket Error Codes to OpenVMS Status Codes. . . . . . . D–1
E–1 Client/Server Programming Examples . . . . . . . . . . . . . . . . . . . . . . . . . E–1
ix