From 92b2c4358f57ef84f161efd8370ba4832bd9261a Mon Sep 17 00:00:00 2001 From: Olivier Certner Date: Mon, 29 May 2023 16:06:37 +0200 Subject: [PATCH] login.conf(5): Default values: Rename column, elaborate on absence of such Column "Notes" in fact only contains default values for capabilities, so make this clear by renaming it to "Default". Add a small introductory text mentioning it, and what an absence of default value means (inheritance). PR: 271748 Reviewed by: emaste Approved by: emaste (mentor) MFC after: 3 days Sponsored by: Kumacom SAS Differential Revision: https://reviews.freebsd.org/D40347 --- lib/libutil/login.conf.5 | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/lib/libutil/login.conf.5 b/lib/libutil/login.conf.5 index b2478bb7a88..35ca1145281 100644 --- a/lib/libutil/login.conf.5 +++ b/lib/libutil/login.conf.5 @@ -181,9 +181,15 @@ are considered infinite values. The usual convention to interpolate capability entries using the special .Em tc=value notation may be used. +.Pp +Default values are specified in the +.Ql Default +column. +If there is no default, the value is inherited from the process setting up the +login environment. .Sh RESOURCE LIMITS .Bl -column pseudoterminals indent indent -.It Sy "Name Type Notes Description" +.It Sy "Name Type Default Description" .It "coredumpsize size Maximum coredump size limit." .It "cputime time CPU usage limit." .It "datasize size Maximum data size limit." @@ -209,7 +215,7 @@ The maximum and current limits may be specified individually by appending a -max or -cur to the capability name. .Sh ENVIRONMENT .Bl -column ignorenologin indent xbinxxusrxbin -.It Sy "Name Type Notes Description" +.It Sy "Name Type Default Description" .It "charset string Set $MM_CHARSET environment variable to the specified" value. .It "cpumask string List of cpus to bind the user to." @@ -262,7 +268,7 @@ explicitly indicates not to change the umask. .El .Sh AUTHENTICATION .Bl -column passwd_prompt indent indent -.It Sy "Name Type Notes Description" +.It Sy "Name Type Default Description" .\" .It "approve program Program to approve login. .It "copyright file File containing additional copyright information" .It "host.allow list List of remote host wildcards from which users in" @@ -406,7 +412,7 @@ The following capabilities are reserved for the purposes indicated and may be supported by third-party software. They are not implemented in the base system. .Bl -column host.accounted indent indent -.It Sy "Name Type Notes Description" +.It Sy "Name Type Default Description" .It "accounted bool false Enable session time accounting for all users" in this class. .It "auth list passwd Allowed authentication styles." -- 2.45.0