Documentation > Userspace Application > Flags > --pool6

--pool6

Index

  1. Description
  2. Syntax
  3. Options
    1. Operations
    2. --quick
  4. Examples

Description

Interacts with Jool’s IPv6 pool. This “pool” contains the RFC 6052 prefix, which is the basic translation prefix to be added or removed from IPv4 addresses in vanilla SIIT and Stateful NAT64.

Even though we (and the RFC) call it a “pool”, it doesn’t really make sense for it to contain more than one prefix because there’s currently no way to map them to interfaces or pool4 entries. This might change in the future. NAT64 Jool allows you to inject more than one prefix to the pool, but only for backwards compatibility reasons (the translating code always uses the first prefix only). SIIT Jool does not allow you to input more than one prefix.

If the pool is empty, Jool will be unable to address-translate via RFC 6052 (but can still do so via the EAMT).

Syntax

($(jool) can be either jool_siit or jool.)

$(jool) --pool6 [--display]
$(jool) --pool6 --count
$(jool) --pool6 --add <IPv6 prefix> [--force]
$(jool) --pool6 --remove <IPv6 prefix> [--quick]
$(jool) --pool6 --flush [--quick]

Options

Operations

  • --display: The pool’s prefixes are printed in standard output. This is the default operation.
  • --count: The number of prefixes in the pool is printed in standard output.
  • --add: Uploads <prefix> to the pool.
    As per RFC 6052, the prefix length must be 32, 40, 48, 56, 64 or 96.
    In addition, u-bit (the ninth byte of the prefix) must be zero. This constraint isn’t too useful, so you can overcome it by using --force.
  • --remove: Deletes the prefix <prefix> from the pool.
  • --flush: Removes all prefixes from the pool.

--quick

See --quick. Only available on Stateful Jool.

Examples

Display the current prefixes:

$ jool --pool6 --display
64:ff9b::/96
  (Fetched 1 prefixes.)

Display only the prefix count:

$ jool --pool6 --count
1

Remove the default prefix:

$ jool --pool6 --remove 64:ff9b::/96

Add a sample prefix:

$ jool --pool6 --add 2001:db8::/64

Destroy all prefixes. Do not bother cleaning up the garbage:

$ jool --pool6 --flush --quick
en | es