ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê


---d
¬¬¬¬¬¬«


¬
--inet --
--debug

ʬ¬¬ guest1 ¬¬¬ host1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ





guest2 ¬¬¬ host2

6.9.7.3 Parameter

devaddr1-devaddr2

These are the device addresses (address pair) of the PTP device.

PTP

This specifies the PTP device/protocol type.

-n name

For Linux: Specifies the name of the tunnel device to use. The default name is
“/dev/net/tun”, which is correct for version 2.4 and above of the Linux kernel.

For Windows: Identifies the host network adapter. If your network adapter does
not have a permanent (static) IP address assigned to it (e.g. you use DHCP
and have a dynamic IP assigned) then instead of specifying an IP address you
must specify the MAC address of the adapter. TunTap32 will automatically se-
lect the first network adapter it finds if this option is omitted, this may not be
desirable depending on your configuration.

--dev name

This is the same as “-n name”.

--m mac

This is the optional hardware address of the interface in the format of either
“xx:xx:xx:xx:xx:xx” or “xx-xx-xx-xx-xx-xx”.

--macaddr mac

This is the same as “-m mac”.

-t mtu

Linux only: Specifies the maximum transmission unit size (default 1500 bytes).

--mtu mtu

This is the same as “-t mtu”.

-i ibuff

Windows only: This specifies the TunTap32 I/O buffer size in KB. nnnn hast to
be between 16 and 1024 (1 MB). The default value is 64 KB.

--ibuff ibuff

This is the same as “-i ibuff”.

-k kbuff

Windows only: This specifies the WinPcap device driver capture buffer size in
KB. nnnn hast to be between 64 and 16384 (16 MB). The default value is 1024
(1 MB).

--kbuff kbuff

This is the same as “-k kbuff”.

-4

Indicates that when a host name is specified for guest1, it must resolve to an
IPv4 address.

--inet

This is the same as “-4”.

-6

Indicates that when a host name is specified for guest1, it must resolve to an
IPv6 address.

--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


Previous Page Next Page