Hi, On Tue, Sep 13, 2022 at 11:38:29PM +0200, Antonio Quartulli wrote: > > + On other platforms, ``--dev-node node`` will influence the naming of the > > + created tun/tap device, if supported on that platform. If OpenVPN cannot > > + figure out whether ``node`` is a TUN or TAP device based on the name, > > + you should also specify ``--dev-type tun`` or ``--dev-type tap``. > > + > > --dev-type device-type > > Which device type are we using? ``device-type`` should be :code:`tun` > > (OSI Layer 3) or :code:`tap` (OSI Layer 2). Use this option only if > > > I like this improved version as it tries to bring clarity. However, I > feel it is too vague as to which platform does what. > > For example the last paragraph starts with "On other platform", but what > are these "other platforms"?
The intent was to list the 3 platforms where --dev-node does something
special, and then "other platforms" is "everything else" (technically,
all platforms that call open_tun_generic(), so I'm not absolutely sure
if AIX or Solaris qualify... but I'm not going to mention AIX or Solaris
there, as it's way too unimportant and will just increase text length).
Especially as it's not even working on "all other platforms" due to
limitations, the documentation won't get less vague than the actual
implementation...
> Maybe it's just me, but saying "other platforms" or "some platforms" or
> "most platforms" without explicitly saying which ones is the same as to
> not really documenting the behaviour. Because I am still unable to
> understand which platform does what.
>
> Should we rather split this platform by platform with related paragraphs?
>
> What do you think?
We could do that, and nobody would really read it - it would just get
long, with quite some repetitions (the BSDs are all very similar, except
when they are not)...
I'm still for "on platforms that are not Windows, MacOS or Linux, --dev-node
will usually not do what you want, so forget about it right away" - wrapped
in a slightly longer text :-)
gert
--
"If was one thing all people took for granted, was conviction that if you
feed honest figures into a computer, honest figures come out. Never doubted
it myself till I met a computer with a sense of humor."
Robert A. Heinlein, The Moon is a Harsh Mistress
Gert Doering - Munich, Germany g...@greenie.muc.de
signature.asc
Description: PGP signature
_______________________________________________ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
