--inet6

This is the same as “-6”.

-d

Specifies that debugging output has to be produced on the Hercules control
panel. Warning: This will produce a tremendous amount of output to the Her-
cules console and should therefore normally be left unspecified.

--debug

This is the same as “-d”.

guest1

Specifies the host name or the IP address of the guest operating system
running under Hercules.

host1

Identifies the host network adapter to use.

guest2

Specifies the host name or the IP address of the guest operating system
running under Hercules.

host2

Identifies the host network adapter to use.

The values for guest1 and host1 must both be of the same address family, i.e. both IPv4 or both IPv6.

The values for guest2 and host2, if specified, must both be of the same address family, i.e. both IPv4 or
both IPv6, and must not be of the same address family as guest1 and host1.

If a host name is specified for guest1 and the host name can be resolved to both an IPv4 and an IPv6
address, then use either the “-4/--inet” or the “-6/--inet6” option to specify which address family should be
used. If neither the “-4/--inet” or the “-6/--inet6” option is specified then whichever address family the re-
solver returns first will be used.

If guest1/host1 or guest2/host2 are IPv4 addresses or are host names that will resolve to IPv4 addresses,
guest1/guest2 can be followed by the prefix size expressed in CIDR notation, for example
192.168.1.1/24. If the prefix size is specified it can have a value from 0 to 32; if it is not specified then a
value of 32 is assumed. The prefix size is used to produce the equivalent subnet mask. For example, a
value of 24 produces a subnet mask of 255.255.255.0.

If guest1/host1 or guest2/host2 are IPv6 addresses, or host names that resolve to IPv6 addresses, then
host1/host2 can be followed by the prefix size expressed in CIDR notation, for example
2001:db8:3003:1::543:210f/48. If the prefix size is specified it can have a value from 0 to 128; if not
specified a value of 128 is assumed.

If guest1, host1, guest2 or host2 are numeric IPv6 addresses, they can be coded between braces, for
example [2001:db8:3003:1::543:210f].

6.9.7.4 Examples

Example 1:

Define a PTP device on addresses 0E20 and 0E21. The IP address of the guest operating system
running under Hercules is 192.168.1.99, whereas the host IP address (the network adapter) to use is
192.168.1.100.

0E20.2 PTP 192.168.1.99 192.168.1.100

or

0E20 PTP 192.168.1.99 192.168.1.100
0E21 PTP 192.168.1.99 192.168.1.100


Example 2:

Define PTP (MPCPTP ESCON CTC link) adapters on device addresses 0440 and 0441. The name of the
TUN/TAP special character device is “/dev/net/tun”. The IP address of the Hercules guest OS side is
192.168.1.99, the host network adapter to use is 192.168.1.100

0440.2 PTP -n /dev/net/tun 192.168.1.99 192.168.1.100

or

0440 PTP -n /dev/net/tun 192.168.1.99 192.168.1.100
0441 PTP -n /dev/net/tun 192.168.1.99 192.168.1.100

Example 3:

Define PTP (MPCPTP ESCON CTC link) adapters on device addresses 0E20 and 0E21. The WinPcap
device driver capture buffer has to be set to 2048 KB and the TunTap32 I/O buffer size has to be set to
256 KB. The IP address of the guest operating system running under Hercules is 192.168.1.99 and the
MAC address of the network adapter to use is 00-80-B3-E1-DF-69.

0E20.2 3088 PTP -n 00-80-B3-E1-DF-69 -k 2048 -i 256 192.168.1.99 0.0.0.0

or

0E20 3088 PTP -n 00-80-B3-E1-DF-69 -k 2048 -i 256 192.168.1.99 0.0.0.0
0E21 3088 PTP -n 00-80-B3-E1-DF-69 -k 2048 -i 256 192.168.1.99 0.0.0.0

6.9.8 VMNET (Channel-to-Channel link via SLIP/VMNET)

6.9.8.1 Function

If the emulation mode is not specified on the configuration statement, it is assumed to be a point-to-point
link to the driving system's TCP/IP stack using Willem Konynenberg's VMNET package. This provides the
same function as the CTCI mode of operation, except that it uses a virtual SLIP interface instead of the
TUN/TAP driver.

Previous Page Next Page