diff mbox series

[bug#48607] documentation: add explanation for wireguard keep-alive setting

Message ID 20210523131342.15fb478c@perso.pw
State Accepted
Headers show
Series [bug#48607] documentation: add explanation for wireguard keep-alive setting | expand

Checks

Context Check Description
cbaines/comparison success View comparision
cbaines/git branch success View Git branch
cbaines/applying patch success View Laminar job
cbaines/issue success View issue

Commit Message

Solene Rapenne May 23, 2021, 11:13 a.m. UTC
---
 doc/guix.texi | 5 +++++
 1 file changed, 5 insertions(+)

Comments

Guillaume Le Vaillant May 23, 2021, 4:11 p.m. UTC | #1
Solene Rapenne <solene@perso.pw> skribis:

> ---
>  doc/guix.texi | 5 +++++
>  1 file changed, 5 insertions(+)
>
> diff --git a/doc/guix.texi b/doc/guix.texi
> index e8b0485f78..1d2d14d332 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -27104,6 +27104,11 @@ the file does not exist.
>  The authorized peers on this interface.  This is a list of
>  @var{wireguard-peer} records.
>  
> +@item @code{keep-alive} (default: @code{#f})
> +The seconds between keepalive packets, may be required to keep the VPN
> +alive behind a NAT.  When set to @code{#f} there is no keepalive and
> +the VPN is fully stateless.
> +
>  @end table
>  @end deftp

Hi,

There's already a description for 'keep-alive' in the section about
the 'wireguard-peer' data type, around line 27128.
Solene Rapenne May 23, 2021, 4:32 p.m. UTC | #2
Le Sun, 23 May 2021 16:11:00 +0000,
Guillaume Le Vaillant <glv@posteo.net> a écrit :

> Solene Rapenne <solene@perso.pw> skribis:
> 
> > ---
> >  doc/guix.texi | 5 +++++
> >  1 file changed, 5 insertions(+)
> >
> > diff --git a/doc/guix.texi b/doc/guix.texi
> > index e8b0485f78..1d2d14d332 100644
> > --- a/doc/guix.texi
> > +++ b/doc/guix.texi
> > @@ -27104,6 +27104,11 @@ the file does not exist.
> >  The authorized peers on this interface.  This is a list of
> >  @var{wireguard-peer} records.
> >  
> > +@item @code{keep-alive} (default: @code{#f})
> > +The seconds between keepalive packets, may be required to keep the
> > VPN +alive behind a NAT.  When set to @code{#f} there is no
> > keepalive and +the VPN is fully stateless.
> > +
> >  @end table
> >  @end deftp  
> 
> Hi,
> 
> There's already a description for 'keep-alive' in the section about
> the 'wireguard-peer' data type, around line 27128.

Indeed, I missed it, but then why doesn't it appear on this url?
https://guix.gnu.org/manual/en/guix.html#index-wireguard_002dpeer
Guillaume Le Vaillant May 23, 2021, 5:11 p.m. UTC | #3
Solene Rapenne <solene@perso.pw> skribis:

> Le Sun, 23 May 2021 16:11:00 +0000,
> Guillaume Le Vaillant <glv@posteo.net> a écrit :
>
>> Solene Rapenne <solene@perso.pw> skribis:
>> 
>> > ---
>> >  doc/guix.texi | 5 +++++
>> >  1 file changed, 5 insertions(+)
>> >
>> > diff --git a/doc/guix.texi b/doc/guix.texi
>> > index e8b0485f78..1d2d14d332 100644
>> > --- a/doc/guix.texi
>> > +++ b/doc/guix.texi
>> > @@ -27104,6 +27104,11 @@ the file does not exist.
>> >  The authorized peers on this interface.  This is a list of
>> >  @var{wireguard-peer} records.
>> >  
>> > +@item @code{keep-alive} (default: @code{#f})
>> > +The seconds between keepalive packets, may be required to keep the
>> > VPN +alive behind a NAT.  When set to @code{#f} there is no
>> > keepalive and +the VPN is fully stateless.
>> > +
>> >  @end table
>> >  @end deftp  
>> 
>> Hi,
>> 
>> There's already a description for 'keep-alive' in the section about
>> the 'wireguard-peer' data type, around line 27128.
>
> Indeed, I missed it, but then why doesn't it appear on this url?
> https://guix.gnu.org/manual/en/guix.html#index-wireguard_002dpeer

I guess it was added after the branch for the current stable version of
Guix was created.
It appears in the manual of the current/devel version at
https://guix.gnu.org/manual/devel/en/guix.html#index-wireguard_002dpeer

I'm closing this issue then.
diff mbox series

Patch

diff --git a/doc/guix.texi b/doc/guix.texi
index e8b0485f78..1d2d14d332 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -27104,6 +27104,11 @@  the file does not exist.
 The authorized peers on this interface.  This is a list of
 @var{wireguard-peer} records.
 
+@item @code{keep-alive} (default: @code{#f})
+The seconds between keepalive packets, may be required to keep the VPN
+alive behind a NAT.  When set to @code{#f} there is no keepalive and
+the VPN is fully stateless.
+
 @end table
 @end deftp