Constructing the Network Parameter

The network parameter consists of up to three parts, separated by semicolons—network, multicast groups, send address—as in these examples:

"lan0"

network only

"lan0;225.1.1.1"

one multicast group

"lan0;225.1.1.1,225.1.1.5;225.1.1.6"

two multicast groups, send address

"lan0;;225.1.1.6"

no multicast group, send address

Part One—Network

Part one identifies the network, which you can specify in several ways:

Specify Network

Host name

When a program specifies a host name, the transport creation call uses an operating system call that searches a network database to obtain the IP address. The maximum length of a host name string is 256 characters.

Host IP address

When a program specifies an IP address, it must be a string representing a multi-part address. For example:

   "101.120.115.111"

Network name (where supported)

When an application specifies a network name, the transport creation function calls getnetbyname(), which searches a network database such as Network Information Services (NIS) or a flat file (such as networks) in the system directory.

Network IP number

If a program specifies a host IP address or a network IP number it must be in dotted-decimal notation. For example, 101.55.1.10.

Interface name (where supported)

When an application specifies an interface name, the transport creation function searches the interface table for the specified interface name. For example, lan0.

The interface name must be one that is known to ifconfig or netstat.

Default

(Non-Secure Daemons)

If a program does not specify a network, the transport creation function uses the default network that corresponds to the host name of the system as determined by the C function gethostname().

Default

(Secure Daemons)

Secure daemons use internal defaults, which must be set explicitly by the administrator; see Default Network and Service.

The use of the UDP broadcast protocol has generally been superseded by the IP multicast protocol. To use broadcast protocols without multicast addressing, specify only part one of the network parameter, and omit the remaining parts.

Part Two—Multicast Groups

Part two is a list of zero or more multicast groups to join, specified as IP addresses, separated by commas. Each address in part two must denote a valid multicast address. Joining a multicast group enables listeners on the resulting transport to receive data sent to that multicast group.

For a brief introduction to multicasting, see Multicast Addressing.

Part Three—Send Address

Part three is a single send address. When a program sends broadcast data on the resulting transport, it is sent to this address. (Point‑to‑point data is not affected.) If present, this item must be an IP address—not a host name or network name. The send address need not be among the list of multicast groups joined in part two.

If you join one or more multicast groups in part two, but do not specify a send address in part three, the send address defaults to the first multicast group listed in part two.