Debian Codegraph @

upstream/debian-unstable/man8/ip-sr.8

raw
1 .TH IP\-SR 8 "14 Apr 2017" "iproute2" "Linux"
2 .SH "NAME"
3 ip-sr \- IPv6 Segment Routing management
4 .SH SYNOPSIS
5 .sp
6 .ad l
7 .in +8
8 .ti -8
9 .B ip sr
10 .RI " { " COMMAND " | "
11 .BR help " }"
12 .sp
13 .ti -8
14
15 .ti -8
16 .B ip sr hmac show
17
18 .ti -8
19 .B ip sr hmac set
20 .I KEYID ALGO
21
22 .ti -8
23 .B ip sr tunsrc show
24
25 .ti -8
26 .B ip sr tunsrc set
27 .I ADDRESS
28
29 .SH DESCRIPTION
30 The \fBip sr\fR command is used to configure IPv6 Segment Routing (SRv6)
31 internal parameters.
32 .PP
33 Those parameters include the mapping between an HMAC key ID and its associated
34 hashing algorithm and secret, and the IPv6 address to use as source for encapsulated
35 packets.
36 .PP
37 The \fBip sr hmac set\fR command prompts for a newline-terminated "passphrase"
38 that will be used as the HMAC secret for the corresponding key ID. This
39 "passphrase" is \fInot\fR stretched, and it is used directly as the HMAC key.
40 Therefore it \fImust\fR have enough entropy to be used as a key. For example, a
41 correct use would be to use a passphrase that was generated using
42 \fBhead\~-c\~32\~/dev/random\~|\~base64\~-w\~0\fR.
43 .PP
44 A blank "passphrase" removes the mapping.
45 .PP
46 The currently supported algorithms for \fIALGO\fR are \fBsha1\fR and
47 \fBsha256\fR.
48 .PP
49 If the tunnel source is set to the address :: (which is the default), then an address
50 of the egress interface will be selected. As this operation may hinder performances,
51 it is recommended to set a non-default address.
52
53 .SH EXAMPLES
54 .PP
55 .SS Configure an HMAC mapping for key ID 42 and hashing algorithm SHA-256
56 .nf
57 # ip sr hmac set 42 sha256
58 .PP
59 .SS Set the tunnel source address to 2001:db8::1
60 .nf
61 # ip sr tunsrc set 2001:db8::1
62 .SH SEE ALSO
63 .br
64 .BR ip-route (8)
65
66 .SH BUGS
67 \fBip sr hmac set\fR does not stretch the passphrase.
68
69 .SH AUTHOR
70 David Lebrun <[email protected]>