NAME

       ipset-translate — translation tool to migrate from ipset to nftables

DESCRIPTION

       This tool allows system administrators to translate a given IP sets file to nftables(8).

       The only available command is:

       • ipset-translate restores < file.ipt

USAGE

       The ipset-translate tool reads an IP sets file in the syntax produced by ipset(8) save. No
       set modifications occur, this tool is a text converter.

EXAMPLES

       Basic operation examples.

       Single command translation, assuming the original file:

       create test1 hash:ip,port family inet counters timeout 300 hashsize 1024 maxelem 65536 bucketsize 12 initval 0xb5c4be5d
       add test1 1.1.1.1,udp:20
       add test1 1.1.1.1,21
       create test2 hash:ip,port family inet hashsize 1024 maxelem 65536 bucketsize 12 initval 0xb5c4be5d

       which results in the following translation:

       root@machine:~# ipset-translate restore < file.ipt
       add set inet global test1 { type ipv4_addr . inet_proto . inet_service; counter; timeout 300s; size 65536; }
       add element inet global test1 { 1.1.1.1 . udp . 20 }
       add element inet global test1 { 1.1.1.1 . tcp . 21 }
       add set inet global test2 { type ipv4_addr . inet_proto . inet_service; size 65536; }

LIMITATIONS

       A few IP sets options may be not  supported  because  they  are  not  yet  implemented  in
       nftables(8).

       Contrary  to  nftables(8),  IP sets are not attached to a specific table.  The translation
       utility assumes that sets are created in a table whose name is global and family is  inet.
       You  might  want  to  update  the  resulting translation to use a different table name and
       family for your sets.

       To get up-to-date information about this, please head to https://wiki.nftables.org/.

SEE ALSO

       nft(8), ipset(8)

AUTHORS

       The   nftables    framework    has    been    written    by    the    Netfilter    Project
       (https://www.netfilter.org).

       This manual page was written by Pablo Neira Ayuso <pablo@netfilter.org>.

       This documentation is free/libre under the terms of the GPLv2+.

       This tool was funded through the NGI0 PET Fund, a fund established by NLnet with financial
       support from the European Commission's Next Generation Internet programme, under the aegis
       of DG Communications Networks, Content and Technology under grant agreement No 825310.

                                           May 31, 2021                        IPSET-TRANSLATE(8)