History log of /openbsd-current/share/man/man4/tun.4
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.45 09-Jan-2020 claudio

Cleanup ioctl(2) list. FIONBIO, FIOASYNC and FIONREAD are not defined
in <net/if_tun.h> also there is no need to document them again. Instead
reference to ioctl(2) that has all the info. Also remove TIOCSPGRP and
TIOCGPGRP and replace them with FIOSETOWN and FIOGETOWN. Users should
use those ioctl(2) to set the process / process group to be signaled
when FIOASYNC is set.
OK visa@


Revision tags: OPENBSD_6_5_BASE OPENBSD_6_6_BASE
# 1.44 06-Jan-2019 tedu

mention that tun is a point-to-point interface so that we know what
word to search for in ifconfig(4).
from claudio


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE OPENBSD_6_4_BASE
# 1.43 23-Oct-2015 claudio

From jmc@ "the exclusive open propery" does not make sense. Try with 'an'.


# 1.42 23-Oct-2015 claudio

Adjust tun(4) and tap(4) after the split.
Note: "pseudo-device tun" is used by both devices this is not a typo
OK dlg@ mpi@


# 1.41 14-Sep-2015 schwarze

convert .Fd #include to .In


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE
# 1.40 21-Jan-2014 schwarze

obvious .Pa fixes; found with mandocdb(8)


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE OPENBSD_5_4_BASE
# 1.39 02-May-2011 jmc

no need to escape `|'; as discussed with schwartze


Revision tags: OPENBSD_4_9_BASE
# 1.38 23-Sep-2010 matthew

Eliminate mention of EPERM error condition from tun(4) man page. We
just use the filesystem permissions now.

Pointed out by stsp@.


# 1.37 26-Aug-2010 claudio

Try to be a bit more specific about what happens when link0 is used.
link0 will reset the interface and all configuration is lost (e.g. -inet6 or
rdomain settings) so use link0 as first command without any other arguments
to get a deterministic behaviour.
With a lot of help by jmc@ (actually commiting his version because it is much
nicer, as ususal).


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE
# 1.36 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.35 21-Feb-2007 claudio

Sync with reality. Initial diff by Ingo Schwarze additional help by jmc@


Revision tags: OPENBSD_4_0_BASE
# 1.34 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.33 02-Sep-2004 jaredy

minor mdoc fixes
consistency in wording
fix ioctl listing

ok jmc


# 1.32 17-Aug-2004 jaredy

keep all "ifconfig <cloneable> create" examples the same

ok jmc


# 1.31 28-Jul-2004 jmc

hostname.tun can be used to set link0, so add standard hostname.if(5)/
netstart(8) blurb; spotted by Alexey E. Suslikov;

also, add hostname.if(5) and netstart(8) to SEE ALSO;


# 1.30 26-Jun-2004 jmc

- hyphenate 4-byte (adjectival)
- uppercase `e' in ethernet
- kill whitespace


# 1.29 25-Jun-2004 claudio

typo noticed by theo.


# 1.28 25-Jun-2004 claudio

Add tap aka layer 2 tunneling support to tun(4). It can be enabled by setting
the link0 flag via ifconfig(8). OK markus@, canacar@ also tested by ish@


Revision tags: OPENBSD_3_5_BASE
# 1.27 08-Dec-2003 markus

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


Revision tags: OPENBSD_3_4_BASE
# 1.26 06-Jun-2003 jmc

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


Revision tags: OPENBSD_3_3_BASE
# 1.25 11-Mar-2003 david

date is supposed to be written formally
ok jmc@


# 1.24 10-Mar-2003 mdw

Fixed some small typos & formatting following suggestions from jmc


# 1.23 09-Mar-2003 deraadt

start of replacement tun page; from mdw


# 1.22 09-Mar-2003 deraadt

der Mouse, ie. "Mike Parker", adamantly refuses to let us put his real
name on a copyright notice, therefore legally this file is not free
software. Mike thinks I am rude for saying that a non-legal license
is not free software. Well, I am sorry, but legally we *must* remove
it. I can't believe how IRC some people are...
Anyone want to step up and write a free replacement for this page? If
you can write a free replacement in a day or so, that would be awesome.


# 1.21 18-Feb-2003 jmc

copyrights added;

ac97(4): Constantine Sapuntzakis
scsi(4): Julian Elischer
tun(4): der Mouse (thanks mickey@ for help with this one)
vlan(4): Jason R. Thorpe


Revision tags: OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.20 05-Oct-2001 mpech

Powered by @mantoya:
o) start new sentence on a new line;
o) minor mdoc fixes;
millert@ ok

Tip of the day: www.mpechismazohist.com


# 1.19 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.18 05-Mar-2001 angelos

Rename TUNSMODE to TUNSIFMODE


# 1.17 09-Jan-2001 krw

Typo: 'eg.' -> 'e.g.'


# 1.16 21-Dec-2000 aaron

Various repairs, $Id$ tags added, etc.


Revision tags: OPENBSD_2_8_BASE
# 1.15 17-Sep-2000 aaron

Zap some unwanted trailing whitespace.


# 1.14 23-May-2000 deraadt

doc actual tun behaviour; jon@spock.org


Revision tags: OPENBSD_2_7_BASE
# 1.13 15-Apr-2000 aaron

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.


# 1.12 16-Dec-1999 deraadt

Xr inet6 4


Revision tags: OPENBSD_2_6_BASE
# 1.11 23-Sep-1999 alex

Typo fixes.


# 1.10 05-Jun-1999 aaron

more .Os cleanup, remove some trailing whitespace, cleanse some .Nm


# 1.9 16-May-1999 alex

Cleanup xrefs under SEE ALSO. Specifically:

- Sort xrefs by section, and then alphabetically.
- Add missing commas between xref items.
- Remove commas from the last xref entry.
- Remove duplicate entries.


Revision tags: OPENBSD_2_5_BASE
# 1.8 01-Mar-1999 aaron

currect -> current; d@


# 1.7 04-Nov-1998 mickey

kill bogus sentence, probably scribbled by me. noticed by espie@


# 1.6 31-Oct-1998 espie

Fix netintro/intro muck-up.


Revision tags: OPENBSD_2_4_BASE
# 1.5 06-Sep-1998 aaron

More man page fixes. Spelling, grammar, some typos. Lots of double-word
occurrences squashed as well.


Revision tags: OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.4 07-Sep-1997 deraadt

neat typo


# 1.3 02-Aug-1997 deraadt

pass address family as host-byte-order u_int32_t. this fixes bpf. add a
note to the bottom of tun.4 to indicate that this is a binary
incompatibility with older versions, and describe all 3 revisions this
has gone through. everyone -- recompile your code that uses tun.


Revision tags: OPENBSD_2_1_BASE
# 1.2 16-Dec-1996 deraadt

fix .Nm stuff so that man -k works


# 1.1 14-Oct-1996 mickey

add tun pseudo-device interface manual.
from der mouse Net's PR, if i didn't missed my memory...
it was lost in my tree a long ago (:


# 1.44 06-Jan-2019 tedu

mention that tun is a point-to-point interface so that we know what
word to search for in ifconfig(4).
from claudio


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE OPENBSD_6_4_BASE
# 1.43 23-Oct-2015 claudio

From jmc@ "the exclusive open propery" does not make sense. Try with 'an'.


# 1.42 23-Oct-2015 claudio

Adjust tun(4) and tap(4) after the split.
Note: "pseudo-device tun" is used by both devices this is not a typo
OK dlg@ mpi@


# 1.41 14-Sep-2015 schwarze

convert .Fd #include to .In


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE
# 1.40 21-Jan-2014 schwarze

obvious .Pa fixes; found with mandocdb(8)


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE OPENBSD_5_4_BASE
# 1.39 02-May-2011 jmc

no need to escape `|'; as discussed with schwartze


Revision tags: OPENBSD_4_9_BASE
# 1.38 23-Sep-2010 matthew

Eliminate mention of EPERM error condition from tun(4) man page. We
just use the filesystem permissions now.

Pointed out by stsp@.


# 1.37 26-Aug-2010 claudio

Try to be a bit more specific about what happens when link0 is used.
link0 will reset the interface and all configuration is lost (e.g. -inet6 or
rdomain settings) so use link0 as first command without any other arguments
to get a deterministic behaviour.
With a lot of help by jmc@ (actually commiting his version because it is much
nicer, as ususal).


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE
# 1.36 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.35 21-Feb-2007 claudio

Sync with reality. Initial diff by Ingo Schwarze additional help by jmc@


Revision tags: OPENBSD_4_0_BASE
# 1.34 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.33 02-Sep-2004 jaredy

minor mdoc fixes
consistency in wording
fix ioctl listing

ok jmc


# 1.32 17-Aug-2004 jaredy

keep all "ifconfig <cloneable> create" examples the same

ok jmc


# 1.31 28-Jul-2004 jmc

hostname.tun can be used to set link0, so add standard hostname.if(5)/
netstart(8) blurb; spotted by Alexey E. Suslikov;

also, add hostname.if(5) and netstart(8) to SEE ALSO;


# 1.30 26-Jun-2004 jmc

- hyphenate 4-byte (adjectival)
- uppercase `e' in ethernet
- kill whitespace


# 1.29 25-Jun-2004 claudio

typo noticed by theo.


# 1.28 25-Jun-2004 claudio

Add tap aka layer 2 tunneling support to tun(4). It can be enabled by setting
the link0 flag via ifconfig(8). OK markus@, canacar@ also tested by ish@


Revision tags: OPENBSD_3_5_BASE
# 1.27 08-Dec-2003 markus

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


Revision tags: OPENBSD_3_4_BASE
# 1.26 06-Jun-2003 jmc

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


Revision tags: OPENBSD_3_3_BASE
# 1.25 11-Mar-2003 david

date is supposed to be written formally
ok jmc@


# 1.24 10-Mar-2003 mdw

Fixed some small typos & formatting following suggestions from jmc


# 1.23 09-Mar-2003 deraadt

start of replacement tun page; from mdw


# 1.22 09-Mar-2003 deraadt

der Mouse, ie. "Mike Parker", adamantly refuses to let us put his real
name on a copyright notice, therefore legally this file is not free
software. Mike thinks I am rude for saying that a non-legal license
is not free software. Well, I am sorry, but legally we *must* remove
it. I can't believe how IRC some people are...
Anyone want to step up and write a free replacement for this page? If
you can write a free replacement in a day or so, that would be awesome.


# 1.21 18-Feb-2003 jmc

copyrights added;

ac97(4): Constantine Sapuntzakis
scsi(4): Julian Elischer
tun(4): der Mouse (thanks mickey@ for help with this one)
vlan(4): Jason R. Thorpe


Revision tags: OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.20 05-Oct-2001 mpech

Powered by @mantoya:
o) start new sentence on a new line;
o) minor mdoc fixes;
millert@ ok

Tip of the day: www.mpechismazohist.com


# 1.19 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.18 05-Mar-2001 angelos

Rename TUNSMODE to TUNSIFMODE


# 1.17 09-Jan-2001 krw

Typo: 'eg.' -> 'e.g.'


# 1.16 21-Dec-2000 aaron

Various repairs, $Id$ tags added, etc.


Revision tags: OPENBSD_2_8_BASE
# 1.15 17-Sep-2000 aaron

Zap some unwanted trailing whitespace.


# 1.14 23-May-2000 deraadt

doc actual tun behaviour; jon@spock.org


Revision tags: OPENBSD_2_7_BASE
# 1.13 15-Apr-2000 aaron

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.


# 1.12 16-Dec-1999 deraadt

Xr inet6 4


Revision tags: OPENBSD_2_6_BASE
# 1.11 23-Sep-1999 alex

Typo fixes.


# 1.10 05-Jun-1999 aaron

more .Os cleanup, remove some trailing whitespace, cleanse some .Nm


# 1.9 16-May-1999 alex

Cleanup xrefs under SEE ALSO. Specifically:

- Sort xrefs by section, and then alphabetically.
- Add missing commas between xref items.
- Remove commas from the last xref entry.
- Remove duplicate entries.


Revision tags: OPENBSD_2_5_BASE
# 1.8 01-Mar-1999 aaron

currect -> current; d@


# 1.7 04-Nov-1998 mickey

kill bogus sentence, probably scribbled by me. noticed by espie@


# 1.6 31-Oct-1998 espie

Fix netintro/intro muck-up.


Revision tags: OPENBSD_2_4_BASE
# 1.5 06-Sep-1998 aaron

More man page fixes. Spelling, grammar, some typos. Lots of double-word
occurrences squashed as well.


Revision tags: OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.4 07-Sep-1997 deraadt

neat typo


# 1.3 02-Aug-1997 deraadt

pass address family as host-byte-order u_int32_t. this fixes bpf. add a
note to the bottom of tun.4 to indicate that this is a binary
incompatibility with older versions, and describe all 3 revisions this
has gone through. everyone -- recompile your code that uses tun.


Revision tags: OPENBSD_2_1_BASE
# 1.2 16-Dec-1996 deraadt

fix .Nm stuff so that man -k works


# 1.1 14-Oct-1996 mickey

add tun pseudo-device interface manual.
from der mouse Net's PR, if i didn't missed my memory...
it was lost in my tree a long ago (:


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.43 23-Oct-2015 claudio

From jmc@ "the exclusive open propery" does not make sense. Try with 'an'.


# 1.42 23-Oct-2015 claudio

Adjust tun(4) and tap(4) after the split.
Note: "pseudo-device tun" is used by both devices this is not a typo
OK dlg@ mpi@


# 1.41 14-Sep-2015 schwarze

convert .Fd #include to .In


Revision tags: OPENBSD_5_5_BASE OPENBSD_5_6_BASE OPENBSD_5_7_BASE OPENBSD_5_8_BASE
# 1.40 21-Jan-2014 schwarze

obvious .Pa fixes; found with mandocdb(8)


Revision tags: OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE OPENBSD_5_4_BASE
# 1.39 02-May-2011 jmc

no need to escape `|'; as discussed with schwartze


Revision tags: OPENBSD_4_9_BASE
# 1.38 23-Sep-2010 matthew

Eliminate mention of EPERM error condition from tun(4) man page. We
just use the filesystem permissions now.

Pointed out by stsp@.


# 1.37 26-Aug-2010 claudio

Try to be a bit more specific about what happens when link0 is used.
link0 will reset the interface and all configuration is lost (e.g. -inet6 or
rdomain settings) so use link0 as first command without any other arguments
to get a deterministic behaviour.
With a lot of help by jmc@ (actually commiting his version because it is much
nicer, as ususal).


Revision tags: OPENBSD_4_2_BASE OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE
# 1.36 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.35 21-Feb-2007 claudio

Sync with reality. Initial diff by Ingo Schwarze additional help by jmc@


Revision tags: OPENBSD_4_0_BASE
# 1.34 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.33 02-Sep-2004 jaredy

minor mdoc fixes
consistency in wording
fix ioctl listing

ok jmc


# 1.32 17-Aug-2004 jaredy

keep all "ifconfig <cloneable> create" examples the same

ok jmc


# 1.31 28-Jul-2004 jmc

hostname.tun can be used to set link0, so add standard hostname.if(5)/
netstart(8) blurb; spotted by Alexey E. Suslikov;

also, add hostname.if(5) and netstart(8) to SEE ALSO;


# 1.30 26-Jun-2004 jmc

- hyphenate 4-byte (adjectival)
- uppercase `e' in ethernet
- kill whitespace


# 1.29 25-Jun-2004 claudio

typo noticed by theo.


# 1.28 25-Jun-2004 claudio

Add tap aka layer 2 tunneling support to tun(4). It can be enabled by setting
the link0 flag via ifconfig(8). OK markus@, canacar@ also tested by ish@


Revision tags: OPENBSD_3_5_BASE
# 1.27 08-Dec-2003 markus

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


Revision tags: OPENBSD_3_4_BASE
# 1.26 06-Jun-2003 jmc

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


Revision tags: OPENBSD_3_3_BASE
# 1.25 11-Mar-2003 david

date is supposed to be written formally
ok jmc@


# 1.24 10-Mar-2003 mdw

Fixed some small typos & formatting following suggestions from jmc


# 1.23 09-Mar-2003 deraadt

start of replacement tun page; from mdw


# 1.22 09-Mar-2003 deraadt

der Mouse, ie. "Mike Parker", adamantly refuses to let us put his real
name on a copyright notice, therefore legally this file is not free
software. Mike thinks I am rude for saying that a non-legal license
is not free software. Well, I am sorry, but legally we *must* remove
it. I can't believe how IRC some people are...
Anyone want to step up and write a free replacement for this page? If
you can write a free replacement in a day or so, that would be awesome.


# 1.21 18-Feb-2003 jmc

copyrights added;

ac97(4): Constantine Sapuntzakis
scsi(4): Julian Elischer
tun(4): der Mouse (thanks mickey@ for help with this one)
vlan(4): Jason R. Thorpe


Revision tags: OPENBSD_3_0_BASE OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.20 05-Oct-2001 mpech

Powered by @mantoya:
o) start new sentence on a new line;
o) minor mdoc fixes;
millert@ ok

Tip of the day: www.mpechismazohist.com


# 1.19 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.18 05-Mar-2001 angelos

Rename TUNSMODE to TUNSIFMODE


# 1.17 09-Jan-2001 krw

Typo: 'eg.' -> 'e.g.'


# 1.16 21-Dec-2000 aaron

Various repairs, $Id$ tags added, etc.


Revision tags: OPENBSD_2_8_BASE
# 1.15 17-Sep-2000 aaron

Zap some unwanted trailing whitespace.


# 1.14 23-May-2000 deraadt

doc actual tun behaviour; jon@spock.org


Revision tags: OPENBSD_2_7_BASE
# 1.13 15-Apr-2000 aaron

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.


# 1.12 16-Dec-1999 deraadt

Xr inet6 4


Revision tags: OPENBSD_2_6_BASE
# 1.11 23-Sep-1999 alex

Typo fixes.


# 1.10 05-Jun-1999 aaron

more .Os cleanup, remove some trailing whitespace, cleanse some .Nm


# 1.9 16-May-1999 alex

Cleanup xrefs under SEE ALSO. Specifically:

- Sort xrefs by section, and then alphabetically.
- Add missing commas between xref items.
- Remove commas from the last xref entry.
- Remove duplicate entries.


Revision tags: OPENBSD_2_5_BASE
# 1.8 01-Mar-1999 aaron

currect -> current; d@


# 1.7 04-Nov-1998 mickey

kill bogus sentence, probably scribbled by me. noticed by espie@


# 1.6 31-Oct-1998 espie

Fix netintro/intro muck-up.


Revision tags: OPENBSD_2_4_BASE
# 1.5 06-Sep-1998 aaron

More man page fixes. Spelling, grammar, some typos. Lots of double-word
occurrences squashed as well.


Revision tags: OPENBSD_2_2_BASE OPENBSD_2_3_BASE
# 1.4 07-Sep-1997 deraadt

neat typo


# 1.3 02-Aug-1997 deraadt

pass address family as host-byte-order u_int32_t. this fixes bpf. add a
note to the bottom of tun.4 to indicate that this is a binary
incompatibility with older versions, and describe all 3 revisions this
has gone through. everyone -- recompile your code that uses tun.


Revision tags: OPENBSD_2_1_BASE
# 1.2 16-Dec-1996 deraadt

fix .Nm stuff so that man -k works


# 1.1 14-Oct-1996 mickey

add tun pseudo-device interface manual.
from der mouse Net's PR, if i didn't missed my memory...
it was lost in my tree a long ago (: