freebsd-src/sbin/setkey
John Baldwin 6835ace580 setkey(8): Clarify language around AEAD ciphers.
AEAD ciphers for IPsec combine both encryption and authentication.  As
such, ESP configurations using an AEAD cipher should not use a
seperate authentication algorithm via -A.  However, this was not
apparent from the setkey manpage and 12.x and earlier did not perform
sufficient argument validation permitting users to pair an explicit -A
such as SHA256-HMAC with AES-GCM.  (The result was a non-standard
combination of AES-CTR with the specified MAC, but with the wrong
initial block counter (and thus different keystream) compared to using
AES-CTR as the cipher.)

Attempt to clarify this in the manpage by explicitly calling out AEAD
ciphers (currently only AES-GCM) and noting that AEAD ciphers should
not use -A.

While here, explicitly note which authentication algorithms can be
used with esp vs esp-old.  Also add subsection headings for the
different algorithm lists and tidy some language.

I did not convert the tables to column lists (Bl -column) though that
would probably be more correct than using literal blocks (Bd
-literal).

PR:		263379
Reviewed by:	Pau Amma <pauamma@gundo.com>, markj
Differential Revision:	https://reviews.freebsd.org/D34947

(cherry picked from commit e6dede1456)
2022-05-19 17:35:34 -07:00
..
Makefile Remove the link to libl which only contains a stub function 2020-03-23 14:37:00 +00:00
Makefile.depend
parse.y General further adoption of SPDX licensing ID tags. 2017-11-20 19:49:47 +00:00
sample.cf Remove support for IPsec algorithms deprecated in r348205 and r360202. 2020-05-02 00:06:58 +00:00
scriptdump.pl
setkey.8 setkey(8): Clarify language around AEAD ciphers. 2022-05-19 17:35:34 -07:00
setkey.c setkey(8): MFC: load ipsec.ko automatically 2022-05-19 13:05:30 +07:00
test-pfkey.c Remove support for IPsec algorithms deprecated in r348205 and r360202. 2020-05-02 00:06:58 +00:00
test-policy.c General further adoption of SPDX licensing ID tags. 2017-11-20 19:49:47 +00:00
token.l Refer to AES-CBC as "aes-cbc" rather than "rijndael-cbc" for IPsec. 2020-06-04 22:58:37 +00:00
vchar.h General further adoption of SPDX licensing ID tags. 2017-11-20 19:49:47 +00:00