mirror_iproute2/man/man8/ip-token.8
Daniel Borkmann 191b60bd73 ip: ipv6: add tokenized interface identifier support
This patch adds support for tokenized IIDs, that enable
administrators to assign well-known host-part addresses
to nodes whilst still obtaining global network prefix
from Router Advertisements. This is the iproute2 part for
the kernel patch f53adae4eae5 (``net: ipv6: add tokenized
interface identifier support'').

Example commands with iproute2:

Setting a device token:
  # ip token set ::1a:2b:3c:4d/64 dev eth1

Getting a device token:
  # ip token get dev eth1
  token ::1a:2b:3c:4d dev eth1

Listing all tokens:
  # ip token list  (or: ip token)
  token :: dev eth0
  token ::1a:2b:3c:4d dev eth1

Signed-off-by: Daniel Borkmann <dborkman@redhat.com>
Acked-by: Hannes Frederic Sowa <hannes@stressinduktion.org>
2013-05-03 13:17:21 -07:00

67 lines
1.6 KiB
Groff

.TH IP\-TOKEN 8 "28 Mar 2013" "iproute2" "Linux"
.SH "NAME"
ip-token \- tokenized interface identifer support
.SH "SYNOPSIS"
.sp
.ad l
.in +8
.ti -8
.B ip token
.RI " { " COMMAND " | "
.BR help " }"
.sp
.ti -8
.BR "ip token" " { " set " } "
.IR TOKEN
.B dev
.IR DEV
.ti -8
.BR "ip token" " { " get " } "
.B dev
.IR DEV
.ti -8
.BR "ip token" " { " list " }"
.SH "DESCRIPTION"
IPv6 tokenized interface identifer support is used for assigning well-known
host-part addresses to nodes whilst still obtaining a global network prefix
from Router advertisements. The primary target for tokenized identifiers are
server platforms where addresses are usually manually configured, rather than
using DHCPv6 or SLAAC. By using tokenized identifiers, hosts can still
determine their network prefix by use of SLAAC, but more readily be
automatically renumbered should their network prefix change [1]. Tokenized
IPv6 Identifiers are described in the draft
[1]: <draft-chown-6man-tokenised-ipv6-identifiers-02>.
.SS ip token set - set an interface token
set the interface token to the kernel. Once a token is set, it cannot be
removed from the interface, only overwritten.
.TP
.I TOKEN
the interface identifer token address.
.TP
.BI dev " DEV"
the networking interface.
.SS ip token get - get the interface token from the kernel
show a tokenized interface identifer of a particular networking device.
.B Arguments:
coincide with the arguments of
.B ip token set
but the
.I TOKEN
must be left out.
.SS ip token list - list all interface tokens
list all tokenized interface identifers for the networking interfaces from
the kernel.
.SH SEE ALSO
.br
.BR ip (8)
.SH AUTHOR
Manpage by Daniel Borkmann