Minor clarification in ttys(5) man page

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

Minor clarification in ttys(5) man page

Luigi30
You can reload the ttys file by sending SIGHUP to the init process.
init(8) mentions this but ttys(5) does not, which can be confusing for
users who don't know that. I've added a note to this effect to ttys(5)
referencing init(8).

Index: ttys.5
===================================================================
RCS file: /cvs/src/libexec/getty/ttys.5,v
retrieving revision 1.11
diff -u -p -r1.11 ttys.5
--- ttys.5 22 Oct 2008 22:16:16 -0000 1.11
+++ ttys.5 23 Sep 2018 20:21:23 -0000
@@ -129,6 +129,15 @@ may be followed by a quoted command stri
  will execute
  .Em before
  starting the command specified by the second field.
+.El
+.Pp
+Changes to the ttys file will not take effect until it is reloaded by
+.Xr init 8 ,
+which can be triggered without a reboot by sending it a terminal line
hangup
+(HUP) signal. See the
+.Xr init 8
+man page for more information.
+
  .Sh FILES
  .Bl -tag -width /etc/ttys -compact
  .It Pa /etc/ttys

Reply | Threaded
Open this post in threaded view
|

Re: Minor clarification in ttys(5) man page

Jason McIntyre-2
On Sun, Sep 23, 2018 at 06:00:23PM -0400, Katherine Rohl wrote:
> You can reload the ttys file by sending SIGHUP to the init process.
> init(8) mentions this but ttys(5) does not, which can be confusing for
> users who don't know that. I've added a note to this effect to ttys(5)
> referencing init(8).
>

morning.

> Index: ttys.5
> ===================================================================
> RCS file: /cvs/src/libexec/getty/ttys.5,v
> retrieving revision 1.11
> diff -u -p -r1.11 ttys.5
> --- ttys.5 22 Oct 2008 22:16:16 -0000 1.11
> +++ ttys.5 23 Sep 2018 20:21:23 -0000
> @@ -129,6 +129,15 @@ may be followed by a quoted command stri
>   will execute
>   .Em before
>   starting the command specified by the second field.
> +.El
> +.Pp
> +Changes to the ttys file will not take effect until it is reloaded by
> +.Xr init 8 ,
> +which can be triggered without a reboot by sending it a terminal line
> hangup
> +(HUP) signal. See the

you should start new sentences on new lines.

> +.Xr init 8
> +man page for more information.
> +

and the blank line should not be there.

>   .Sh FILES
>   .Bl -tag -width /etc/ttys -compact
>   .It Pa /etc/ttys
>

anyone want to ok this?

jmc

Reply | Threaded
Open this post in threaded view
|

Re: Minor clarification in ttys(5) man page

Jason McIntyre-2
In reply to this post by Luigi30
On Sun, Sep 23, 2018 at 06:00:23PM -0400, Katherine Rohl wrote:

> You can reload the ttys file by sending SIGHUP to the init process.
> init(8) mentions this but ttys(5) does not, which can be confusing for
> users who don't know that. I've added a note to this effect to ttys(5)
> referencing init(8).
>
> Index: ttys.5
> ===================================================================
> RCS file: /cvs/src/libexec/getty/ttys.5,v
> retrieving revision 1.11
> diff -u -p -r1.11 ttys.5
> --- ttys.5 22 Oct 2008 22:16:16 -0000 1.11
> +++ ttys.5 23 Sep 2018 20:21:23 -0000
> @@ -129,6 +129,15 @@ may be followed by a quoted command stri
>   will execute
>   .Em before
>   starting the command specified by the second field.
> +.El
> +.Pp
> +Changes to the ttys file will not take effect until it is reloaded by
> +.Xr init 8 ,
> +which can be triggered without a reboot by sending it a terminal line
> hangup
> +(HUP) signal. See the
> +.Xr init 8
> +man page for more information.
> +
>   .Sh FILES
>   .Bl -tag -width /etc/ttys -compact
>   .It Pa /etc/ttys
>

i committed a shorter version of this (included below).
thanks for the mail,

jmc

Index: ttys.5
===================================================================
RCS file: /cvs/src/libexec/getty/ttys.5,v
retrieving revision 1.11
diff -u -r1.11 ttys.5
--- ttys.5 22 Oct 2008 22:16:16 -0000 1.11
+++ ttys.5 25 Sep 2018 20:01:15 -0000
@@ -129,6 +129,12 @@
 will execute
 .Em before
 starting the command specified by the second field.
+.Pp
+Changes to the ttys file take effect after it has been reloaded by
+.Xr init 8 ,
+which can be triggered by sending it a
+.Dv HUP
+signal.
 .Sh FILES
 .Bl -tag -width /etc/ttys -compact
 .It Pa /etc/ttys