History log of /openbsd-current/share/man/man4/gre.4
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.83 13-Sep-2022 jsg

SIOCDIFPARENT removes configuration not SIOCGIFPARENT
spotted by kn@


# 1.82 12-Sep-2022 jsg

SIOCGIFPARENT uses struct if_parent not ireq
ok jmc@


Revision tags: OPENBSD_6_9_BASE OPENBSD_7_0_BASE OPENBSD_7_1_BASE
# 1.81 08-Jan-2021 kn

Provide "Point-to-Multipoint Layer 3 GRE tunnel interfaces (mgre) example"

From Pierre Emeriaud, thanks!

Feeback jmc
OK dlg


# 1.80 05-Dec-2020 jmc

couple more article fixes;


# 1.79 18-Nov-2020 sthen

s/explicitley/explicitly/


Revision tags: OPENBSD_6_8_BASE
# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.82 12-Sep-2022 jsg

SIOCGIFPARENT uses struct if_parent not ireq
ok jmc@


Revision tags: OPENBSD_6_9_BASE OPENBSD_7_0_BASE OPENBSD_7_1_BASE
# 1.81 08-Jan-2021 kn

Provide "Point-to-Multipoint Layer 3 GRE tunnel interfaces (mgre) example"

From Pierre Emeriaud, thanks!

Feeback jmc
OK dlg


# 1.80 05-Dec-2020 jmc

couple more article fixes;


# 1.79 18-Nov-2020 sthen

s/explicitley/explicitly/


Revision tags: OPENBSD_6_8_BASE
# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.81 08-Jan-2021 kn

Provide "Point-to-Multipoint Layer 3 GRE tunnel interfaces (mgre) example"

From Pierre Emeriaud, thanks!

Feeback jmc
OK dlg


# 1.80 05-Dec-2020 jmc

couple more article fixes;


# 1.79 18-Nov-2020 sthen

s/explicitley/explicitly/


Revision tags: OPENBSD_6_8_BASE
# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.80 05-Dec-2020 jmc

couple more article fixes;


# 1.79 18-Nov-2020 sthen

s/explicitley/explicitly/


Revision tags: OPENBSD_6_8_BASE
# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.79 18-Nov-2020 sthen

s/explicitley/explicitly/


Revision tags: OPENBSD_6_8_BASE
# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.78 18-Jun-2020 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_7_BASE
# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.77 02-Apr-2020 jmc

grammar fix;


Revision tags: OPENBSD_6_6_BASE
# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.76 29-May-2019 fcambus

Fix a bunch of typos in various man pages.


Revision tags: OPENBSD_6_5_BASE
# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.75 16-Nov-2018 dlg

document txprio ioctl support


# 1.74 15-Nov-2018 dlg

admin that eoip(4) comes from the gre pseudo device driver


# 1.73 15-Nov-2018 dlg

spell an ioctl command better.

from markus@


Revision tags: OPENBSD_6_4_BASE
# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.72 20-Apr-2018 bentley

Tweak gre(4):
Correct reference to RFC.
Disambiguate section names.
Lowercase the "using" in Network Virtualization using Generic Routing
Encapsulation.

ok jmc@ schwarze@


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


Revision tags: OPENBSD_6_3_BASE
# 1.71 12-Mar-2018 dlg

gre(4) supports MPLS in GRE encapsulation like rfc 4023 describes


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.70 28-Feb-2018 dlg

update the programming stuff to include mgre


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.69 27-Feb-2018 dlg

enter mgre(4)

this has a really bad description of mgre, but it's a start.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.68 25-Feb-2018 jmc

Pp useless before/after S{h,s};


# 1.67 25-Feb-2018 dlg

give egre an example

nvgre had an example of joining nvgre networks together over the
internet with egre. this takes it away and reworks it for an egre
example.

while here, get rid of the hostnames in the shell prompts so things
are more consistent, which jmc and i discussed.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.66 23-Feb-2018 jmc

various tweaks; ok dlg


# 1.65 23-Feb-2018 dlg

lint fix


# 1.64 23-Feb-2018 dlg

add a SECURITY CONSIDERATIONS section.

mdoc(7) says that section goes last, which is where i put it. i
kind of want it before EXAMPLES though.


# 1.63 23-Feb-2018 dlg

provide some (probably too many) nvgre(4) examples


# 1.62 22-Feb-2018 dlg

try to fix the nvgre words a bit


# 1.61 22-Feb-2018 dlg

speeling


# 1.60 22-Feb-2018 jmc

various tweaks;


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.59 22-Feb-2018 dlg

slight tweak


# 1.58 22-Feb-2018 dlg

reorganise the manpage with subsections for each type of interface.

the page was getting a bit cumbersome with the arrival of nvgre,
so hopefully this makes it a bit more straightforward.

jmc@ says he can fix stuff as i go


# 1.57 22-Feb-2018 dlg

make the Nd lines (subjectively) less worse


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.56 16-Feb-2018 dlg

allow wccp processing to be enabled per interface with the link0 flag.

this also changes the wccp handling to peek into it's payload to
determine whether it is wccp 1 or 2. wccp1 says the gre header is
followed by ipv4, while wccp2 says there's a small header before
the ipv4 packet. the wccp2 header cannot have 4 in the first nibble,
while ipv4 must have 4 in the first nibble. the code now looks at
the nibble to determine whether it should strip the wccp2 header
or not.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.55 15-Feb-2018 jmc

tweak previous; ok dlg


# 1.54 15-Feb-2018 dlg

say that the only optional header we support is the Key.


# 1.53 15-Feb-2018 dlg

there are more GRE rfcs


# 1.52 15-Feb-2018 dlg

make a start at documenting egre(4)


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.51 07-Feb-2018 jmc

tweak previous;


# 1.50 07-Feb-2018 dlg

split mobileip(4) out from the gre(4) driver.

having mobileip in gre makes it hard to cut gre up. the current mobileip
code is also broken, so this is def and improvement. it also makes it
easy to disable and remove mobileip in the future.

ok claudio@ henning@


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.


# 1.49 12-Jan-2018 deraadt

Adjust references for sysctl(3) to sysctl(2)


# 1.48 01-Dec-2017 jmc

remove deprectaed linkX notation;
from lucas gabriel vuotto


Revision tags: OPENBSD_6_2_BASE
# 1.47 08-Jun-2017 tb

wrec.org is dead. Use working links instead.
patch from jj, found by "Norrland" on icb. Thanks!


Revision tags: OPENBSD_6_1_BASE
# 1.46 31-Aug-2016 jmc

shuffle this page a little, to make it read better;


# 1.45 31-Aug-2016 reyk

Split gre(4) into two interfaces: gre(4) and mobileip(4).

Like vlan/svlan and tun/tap, it remains a single driver that decides
on the mode based on the interface name. This removes the need for
removing the default link0 flag to turn gre into Mobile IP mode.
Using linkX / IFF_LINK{0,1,2} for interface modes is a deprecated style.

OK millert@ dlg@ many

Not much consensus on the name but mobileip is also used for the sysctls, so
OK henning@


# 1.44 28-Aug-2016 reyk

Remove obsolete gre(4) ioctls GRESADDRS, GRESADDRD, GREGADDRS,
GREGADDRD, GRESPROTO, and GREGPROTO. They have been replaced by
generic ioctls some time ago (eg. the "ifconfig gre0 tunnel") and
there is no need to keep the old ones around. They are neither used
in base nor in ports.

OK sthen@


Revision tags: OPENBSD_5_8_BASE OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.43 16-Jul-2015 sobrado

double word fix.

ok jmc@


# 1.42 02-Jun-2015 sobrado

write Mobile IP{,v6} in a consistent way, as given in RFCs 5944 and 6275.

ok jmc@


# 1.41 18-Mar-2015 jmc

minor tweaks;


# 1.40 18-Mar-2015 mcbride

"handle" wccp2 packets if net.inet.gre.wccp is set to 2 by truncating
skipping the wccp 2 header. Tested with Cisco ASA.

"looks correct" claudio
ok yasuoka


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.39 19-Oct-2013 schwarze

fix obvious .An formatting errors
found while working on mandoc apropos


Revision tags: OPENBSD_5_4_BASE
# 1.38 16-Jul-2013 schwarze

use .Mt for email addresses; from Jan Stary <hans at stare dot cz>; ok jmc@


Revision tags: OPENBSD_5_3_BASE
# 1.37 26-Sep-2012 jmc

last stage of rfc changes, using consistent Rs/Re blocks, and moving the
references into a STANDARDS section;


# 1.36 18-Aug-2012 jmc

within Rs/Re reference blocks, use %U instead of %O (or any other
variants) for URLs, allowing mandoc -Thtml to properly generate links;

(sendmail.8 changes are simply using Lk, which i somehow missed in previous)

ingo reminded me to verify that gnu groff recognises %U: 1.20.1 does not,
but 1.21 does;


Revision tags: OPENBSD_5_2_BASE
# 1.35 26-Mar-2012 claudio

Try to document how to use gre(4) keepalives with pf(4) enabled.
Adding a rule like "pass quick on gre proto gre no state" will ensure that
the keepalive packets get through pf by bypassing the state table once.
Requested by jsing@ some long time ago.


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE
# 1.34 09-Jul-2011 deraadt

remove more atalk bits


# 1.33 04-Apr-2011 claudio

Update BUGS section. The crazy route lookup is gone so is link1.


Revision tags: OPENBSD_4_8_BASE OPENBSD_4_9_BASE
# 1.32 29-Jun-2010 sthen

Mention keepalives here too; ok jmc@


Revision tags: OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE
# 1.31 26-Jun-2008 ray

First pass at removing clauses 3 and 4 from NetBSD licenses.

Not sure what's more surprising: how long it took for NetBSD to
catch up to the rest of the BSDs (including UCB), or the amount of
code that NetBSD has claimed for itself without attributing to the
actual authors.

OK deraadt@


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE
# 1.30 01-Jun-2007 jmc

enforce DESCRIPTION-after-SYNOPSIS order, to appease man -h;


# 1.29 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_0_BASE OPENBSD_4_1_BASE
# 1.28 25-Jun-2006 brad

add a note for MTU adjustment.

From NetBSD


# 1.27 09-May-2006 jmc

no need to specify a "count" argument: ifconfig(8) handles these
"on demand";

from jan niemann;
ok deraadt


Revision tags: OPENBSD_3_6_BASE OPENBSD_3_7_BASE OPENBSD_3_8_BASE OPENBSD_3_9_BASE
# 1.26 16-Aug-2004 jaredy

mdoc fixes
normalize ioctl listing
convert SEE ALSO to Rs/Re

ok jmc


# 1.25 26-Jul-2004 jmc

.Xr hostname.if 5
.Xr netstart 8

from Alexey E. Suslikov


# 1.24 20-Apr-2004 tedu

GATEWAY and NMBCLUSTERS are dead. ok beck@ deraadt@ jmc@


Revision tags: OPENBSD_3_5_BASE
# 1.23 07-Feb-2004 jmc

remove a typo in the copyright;

with permission of the author (Heiko W. Rupp) and
the (c) holders (The NetBSD Foundation) via wiz@netbsd;


# 1.22 08-Dec-2003 markus

mention ifconfig create; sync synopsis like (Op Ar count). with jmc, deraadt


# 1.21 21-Nov-2003 jmc

WCCPv1, not WCCPv2; from Berk D. Demir;
also alter -width of a list to make it look a bit better;


# 1.20 09-Nov-2003 jmc

remove .Pp's before lists and displays;


Revision tags: OPENBSD_3_4_BASE
# 1.19 31-Aug-2003 jmc

change .Xr to self -> .Nm;


# 1.18 06-Jun-2003 jmc

- section reorder
- some macro fixes
- kill whitespace at EOL


# 1.17 01-Apr-2003 jmc

tidy up of EXAMPLES section;

host A -> Host A
cisco -> Cisco for consistency


Revision tags: OPENBSD_3_3_BASE
# 1.16 16-Mar-2003 jmc

typos;

ddb(4), hilid(4), hilkbd(4), hilms(4): ok miod@
gsckbd(4): found by miod@


# 1.15 06-Mar-2003 david

date should be written formally: .Dd Month day, year
also fixes a few misspellings of the month
ok henning@ jmc@


# 1.14 08-Nov-2002 mpech

Time to cleanup:
o) start new sentence on a new line;
o) wrap long lines;
o) don't use .Pp before/after .Sh, .Ss;
o) OpenBSD -> .Ox;
o) typos;
o) close .Rs;
o) use space between arguments in tag, for example:
.Xr blabla ) .

miod@ ok


Revision tags: OPENBSD_3_2_BASE
# 1.13 10-Jun-2002 itojun

sync with if_gre.c change.


# 1.12 10-Jun-2002 itojun

appletalk and NS are supported. not just IPv4 over IPv4.


Revision tags: OPENBSD_3_1_BASE
# 1.11 03-Apr-2002 angelos

Document new sysctl for WCCP packets -- ok deraadt@


# 1.10 25-Mar-2002 angelos

Verbiage on WCCP support (rather, GRE for WCCPv1) - from joeycoleman@acm.org


Revision tags: OPENBSD_3_0_BASE
# 1.9 03-Aug-2001 mpech

o) We don't like .Pp before/after .Sh;
o) .Nm always has argument in .Sh SYNOPSIS;
o) We always closes .Bl and .Bd tags;

millert@ ok


# 1.8 22-Jun-2001 mpech

o) remove unnecessary .Pp;
o) remove unnecessary .Nm args;
o) closes .Bl;
o) .Sh AUTHOR -> .Sh AUTHORS;
o) sort SEE ALSO;
o) better -mdoc style;
o) typos;

aaron@ ok.


Revision tags: OPENBSD_2_9_BASE
# 1.7 15-Dec-2000 aaron

.Sh EXAMPLE -> .Sh EXAMPLES. Even if there's only one example, at least
this is consistent.


# 1.6 10-Nov-2000 todd

.Sh AUTHOR -> AUTHORS, ok aaron@


Revision tags: OPENBSD_2_8_BASE
# 1.5 18-Oct-2000 aaron

ethernet -> Ethernet


Revision tags: OPENBSD_2_7_BASE
# 1.4 03-Apr-2000 aaron

Remove trailing whitespace.


# 1.3 08-Jan-2000 angelos

A bit more language, and remove references to greconfig(8).


# 1.2 08-Jan-2000 angelos

Work on the language...


# 1.1 07-Jan-2000 angelos

gre(4) man page, from NetBSD.