Bug 196343 - ipsec gif0 setup missing netmask
Summary: ipsec gif0 setup missing netmask
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc mailing list
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-12-29 00:14 UTC by ari
Modified: 2014-12-29 15:06 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description ari 2014-12-29 00:14:47 UTC
The IPSec documentation may contain a bug.

    https://www.freebsd.org/doc/handbook/ipsec.html

In particular, the command is given as:

    # ifconfig gif0 internal1 internal2

and then the resulting gif0 interface looks like

    inet 10.246.38.1 --> 10.0.0.5 netmask 0xffffff00

It would appear that the mask is missing from the command like so:

    # ifconfig gif0 internal1 netmask 255.255.255.0 internal2


Even better, since example IP addresses are used in these docs, write it like this:


    # ifconfig gif0 10.246.38.1 netmask 255.255.255.0 10.0.0.5

and it will be much clearer as to which IP address you are supposed to put where. The documentation never explains which end of the link is supposed to be internal1 and which is internal2. At the very least, rename them as external_remote and external_local.
Comment 1 Andrey V. Elsukov freebsd_committer 2014-12-29 13:53:42 UTC
Also, it will be good to specify 'inet' or 'inet6' keyword in examples.
Comment 2 ari 2014-12-29 15:06:40 UTC
I've just now discovered that the whole gif interface thing is optional for ipsec and not really needed unless you are doing advanced routing things. It would be good if the documentation made that clear.