Documentation > Userspace Application Arguments > --bib



  1. Description
  2. Syntax
  3. Arguments
    1. Operations
    2. Options
  4. Examples


Interacts with Jool’s Binding Information Base (BIB).


jool --bib [--tcp] [--udp] [--icmp] (
	[--display] [--numeric] [--csv]
	| --count
	| --add <IPv4-transport-address> <IPv6-transport-address>
	| --remove <IPv4-transport-address> <IPv6-transport-address>



  • --display: The BIB tables are printed in standard output. This is the default operation.
  • --count: The number of entries per BIB table are printed in standard output.
  • --add: Combines <IPv4-transport-address> and <IPv6-transport-address> into a static BIB entry, and uploads it to Jool’s tables.
    Note that the <IPv4-transport-address> component must be a member of Jool’s IPv4 pool, so make sure you have registered it there first.
  • --remove: Deletes from the tables the BIB entry described by <IPv4-transport-address> and/or <IPv6-transport-address>.
    Within a BIB table, every IPv4 transport address is unique. Within a BIB table, every IPv6 transport address is also unique. Therefore, If you’re removing a BIB entry, you actually only need to provide one transport address. You can still input both to make sure you’re deleting exactly what you want to delete, though.


Flag Description
--tcp If present, the command operates on the TCP table.
--udp If present, the command operates on the UDP table.
--icmp If present, the command operates on the ICMP table.
--numeric By default, the application will attempt to resolve the name of the IPv6 node of each BIB entry. If your nameservers aren’t answering, this will slow the output down.
Use --numeric to turn this behavior off.
--csv Print the table in Comma/Character-Separated Values format. This is intended to be redirected into a .csv file.

--tcp, --udp and --icmp are not mutually exclusive. If neither of them are present, the records are added or removed to/from all three protocols.



  • belongs to the IPv4 pool.
  • The name of 6::6 is “”.
  • 6::6 already spoke to a IPv4 node recently, so the database will not start empty.

Display the entire database:

$ jool --bib --display
[Dynamic] -
  (Fetched 1 entries.)

Publish a couple of TCP services:

# jool --bib --add --tcp 6::6#6
# jool --bib --add --tcp 6::6#66

Display the TCP table:

$ jool --bib --display --tcp
[Static] -
[Static] -
[Dynamic] -
  (Fetched 3 entries.)

Same, but do not query the DNS:

$ jool --bib --display --tcp --numeric
[Static] - 6::6#6
[Static] - 6::6#66
[Dynamic] - 6::6#1234
  (Fetched 3 entries.)

Publish a UDP service:

# jool --bib --add --udp 6::6#6666

Dump the database on a CSV file:

$ jool --bib --display --numeric --csv > bib.csv


Display the number of entries in the TCP and ICMP tables:

$ jool --bib --count --tcp --icmp
TCP: 3

Remove the UDP entry:

# jool --bib --remove --udp 6::6#6666