openbsd/src
1
0
Fork 0
mirror of https://github.com/openbsd/src.git synced 2026-04-24 06:04:47 +00:00
Code Issues Projects Releases Wiki Activity

Make internal hyperlinking work by moving custom sections from .Sh to .Ss

Browse Source 
and the titles from all caps to sentence case such that they match the
table of contents, and switch from .Sy to .Sx as needed.
OK florian@
This commit is contained in:
schwarze
2025-07-08 14:26:45 +00:00
parent 0ba5db8deb
commit bc55f572b2
18 changed files with 193 additions and 193 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
sbin/dhcp6leased/dhcp6leased.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: dhcp6leased.conf.5,v 1.5 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: dhcp6leased.conf.5,v 1.6 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2018, 2021, 2024 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt DHCP6LEASED.CONF 5
.Os
.Sh NAME
@@ -34,20 +34,20 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr dhcp6leased 8 .
.It Sy Prefix delegation
.It Sx Prefix delegation
.Xr dhcp6leased 8
requests prefix delegation from a DHCPv6 server and assigns prefixes
to interfaces.
This section defines on which interfaces prefix delegation should be
requested and to which interfaces prefixes should be assigned.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -59,7 +59,7 @@ Within unquoted arguments, the string
.Pf $ Ar name
is later expanded to
.Ar value .
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
These settings affect the operation of the
.Xr dhcp6leased 8
daemon as a whole.
@@ -68,7 +68,7 @@ daemon as a whole.
Send the rapid commit DHCPv6 option, requesting a two-message exchange
from the server instead of the normal four-message exchange.
.El
.Sh PREFIX DELEGATION
.Ss Prefix delegation
A list of interfaces on which to request prefix delegation:
.Bl -tag -width Ds
.It Ic request prefix delegation on Ar name Ic for Brq Ar name Ns Oo / Ns Ar prefix Oc Ar ...

12
sbin/dhcpleased/dhcpleased.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: dhcpleased.conf.5,v 1.16 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: dhcpleased.conf.5,v 1.17 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2018, 2021 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt DHCPLEASED.CONF 5
.Os
.Sh NAME
@@ -33,15 +33,15 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Interfaces
.It Sx Interfaces
If an interface requires non-default options, they can be defined in
this section.
Most configurations do not require this.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -53,7 +53,7 @@ Within unquoted arguments, the string
.Pf $ Ar name
is later expanded to
.Ar value .
.Sh INTERFACES
.Ss Interfaces
A list of interfaces to overwrite defaults:
.Bl -tag -width Ds
.It Ic interface Ar name Brq Ar option ...

12
sbin/unwind/unwind.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: unwind.conf.5,v 1.36 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: unwind.conf.5,v 1.37 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2018 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt UNWIND.CONF 5
.Os
.Sh NAME
@@ -33,10 +33,10 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr unwind 8 .
.El
@@ -44,7 +44,7 @@ Global settings for
Additional configuration files can be included with the
.Ic include
keyword.
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -66,7 +66,7 @@ fwd1=192.0.2.53
fwd2=192.0.2.153
forwarder { $fwd1 $fwd2 }
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
.Bl -tag -width Ds
.It Ic block list Ar file Op Cm log
A file containing domains to block, one per line.

18
usr.sbin/acme-client/acme-client.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: acme-client.conf.5,v 1.30 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: acme-client.conf.5,v 1.31 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
@@ -17,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt ACME-CLIENT.CONF 5
.Os
.Sh NAME
@@ -28,12 +28,12 @@ The
.Nm
file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Authorities
.It Sx Authorities
Certificate authorities (CAs) that can be contacted via ACME.
.It Sy Domains
.It Sx Domains
Certificate specifications.
.El
.Pp
@@ -54,7 +54,7 @@ the comment is effective until the end of the entire block.
.Pp
Argument names not beginning with a letter, digit, underscore, or '/'
must be quoted.
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -73,7 +73,7 @@ authority letsencrypt {
account key "/etc/acme/letsencrypt-privkey.pem"
}
.Ed
.Sh AUTHORITIES
.Ss Authorities
The configured certificate authorities.
.Pp
Each authority section starts with a declaration of the name identifying a
@@ -108,7 +108,7 @@ Optional
URLs that the authority can use to contact the client for issues related to
this account.
.El
.Sh DOMAINS
.Ss Domains
The certificates to be obtained through ACME.
.Bl -tag -width Ds
.It Ic domain Ar handle Brq ...
@@ -193,7 +193,7 @@ is created if
exists.
.It Ic sign with Ar authority
The certificate authority (as declared above in the
.Sx AUTHORITIES
.Sx Authorities
section) to use.
If this setting is absent, the first authority specified is used.
.It Ic challengedir Ar path

18
usr.sbin/dvmrpd/dvmrpd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: dvmrpd.conf.5,v 1.13 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: dvmrpd.conf.5,v 1.14 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2005, 2006 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
@@ -17,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt DVMRPD.CONF 5
.Os
.Sh NAME
@@ -33,17 +33,17 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr dvmrpd 8 .
A number of global settings can be overruled in specific areas or interfaces.
.It Sy Groups
.It Sx Groups
Groups are used to group similar interfaces, simplifying configuration.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -71,7 +71,7 @@ group {
.Pp
The same can be accomplished by specifying the query-interval
globally or within the group declaration.
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
All interface related settings can be configured globally, per group and per
interface.
The only settings that can be set globally and not overruled are listed below.
@@ -87,7 +87,7 @@ daemon.
The default is
.Ic yes .
.El
.Sh GROUPS
.Ss Groups
Groups can be used to easily configure similar interfaces.
All interface-specific parameters can
be configured per group, overruling the global settings.
@@ -103,7 +103,7 @@ group {
}
.Ed
.El
.Sh INTERFACES
.Ss Interfaces
Each interface can have several parameters configured individually, otherwise
they are inherited.
.Bd -literal -offset indent

20
usr.sbin/eigrpd/eigrpd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: eigrpd.conf.5,v 1.12 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: eigrpd.conf.5,v 1.13 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2015 Renato Westphal <renato@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt EIGRPD.CONF 5
.Os
.Sh NAME
@@ -33,17 +33,17 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr eigrpd 8 .
.It Sy Routing Instances
.It Sx Routing instances
Multiple routing instances can be defined.
Routing instances are defined hierarchically
by address-family and then autonomous-system.
.It Sy Interfaces Configuration
.It Sx Interfaces configuration
Interface-specific parameters.
.El
.Pp
@@ -56,7 +56,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/eigrpd.sub.conf"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -86,7 +86,7 @@ address-family ipv4 {
.Pp
The same can be accomplished by specifying the bandwidth
globally or within the address-family or autonomous-system declaration.
.Sh GLOBAL CONFIGURATION
.Sx Global configuration
Several settings can be configured globally, per address-family, per
autonomous-system and per interface.
The only settings that can be set globally and not overruled are listed below.
@@ -124,7 +124,7 @@ Table 0 is the default table.
Set the router ID; if not specified, the numerically lowest IP address of
the router will be used.
.El
.Sh ROUTING INSTANCES
.Ss Routing instances
Multiple routing instances can be defined.
Routing instances are defined hierarchically
by address-family and then autonomous-system.
@@ -227,7 +227,7 @@ FIB if their metric is lower than the metric of the successor multiplied by the
specified multiplier.
The default value is 1; valid range is 1\-128.
.El
.Sh INTERFACES
.Ss Interfaces configuration
Each interface can have several parameters configured individually, otherwise
they are inherited.
Interfaces can pertain to multiple routing instances.

22
usr.sbin/httpd/httpd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: httpd.conf.5,v 1.126 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: httpd.conf.5,v 1.127 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2014, 2015 Reyk Floeter <reyk@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt HTTPD.CONF 5
.Os
.Sh NAME
@@ -28,15 +28,15 @@ is the configuration file for the HTTP daemon,
.Nm
is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr httpd 8 .
.It Sy Servers
.It Sx Servers
Listening HTTP web servers.
.It Sy Types
.It Sx Types
Media types and extensions.
.El
.Pp
@@ -84,7 +84,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/httpd.conf.local"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -107,7 +107,7 @@ server "example.com" {
listen on $ext_ip port 80
}
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
Here are the settings that can be set globally:
.Bl -tag -width Ds
.It Ic chroot Ar directory
@@ -122,7 +122,7 @@ Set the default media type that is used if the media type for a
specified extension is not found in the configured types or for files
without a file extension;
see the
.Sx TYPES
.Sx Types
section below.
If not specified, the default type is set to
.Ar application/octet-stream .
@@ -178,7 +178,7 @@ to a server.
.Xr httpd 8
runs 3 server processes by default.
.El
.Sh SERVERS
.Ss Servers
The configured web servers.
.Pp
Each
@@ -729,7 +729,7 @@ It is possible to set
to default to use the httpd default timeout of 2 hours.
.El
.El
.Sh TYPES
.Ss Types
Configure the supported media types.
.Xr httpd 8
will set the

18
usr.sbin/ifstated/ifstated.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ifstated.conf.5,v 1.17 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: ifstated.conf.5,v 1.18 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2005 Nikolay Sturm <sturm@openbsd.org>
.\" Copyright (c) 2005 Marco Pfatschbacher <mpf@openbsd.org>
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt IFSTATED.CONF 5
.Os
.Sh NAME
@@ -33,23 +33,23 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ifstated 8 .
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy State Definitions
.It Sx State definitions
Definitions of states and transitions.
.El
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
.Bl -tag -width Ds
.It Ic init-state Ar state
Set the initial state to
.Ar state
instead of using the first state defined.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -101,7 +101,7 @@ links_up = "em0.link.up && em1.link.up"
net = '( "ping -q -c 1 -w 1 192.168.0.1 > /dev/null" every 10 && \e
"ping -q -c 1 -w 1 192.168.0.2 > /dev/null" every 10 )'
.Ed
.Sh TESTS AND EVENTS
.Ss Tests and events
.Xr ifstated 8
delegates the process of testing to libevent which associates a value with
every test, in this case
@@ -110,7 +110,7 @@ or
.Em false .
Whenever the value of a test associated with the current state changes,
an event is triggered and the state's body is processed.
.Sh STATE DEFINITIONS
.Ss State definitions
.Xr ifstated 8
operates on a finite state machine with states and transitions.
.Pp

16
usr.sbin/iscsictl/iscsi.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: iscsi.conf.5,v 1.6 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: iscsi.conf.5,v 1.7 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2012 Claudio Jeker <claudio@openbsd.org>
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
@@ -16,7 +16,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt ISCSI.CONF 5
.Os
.Sh NAME
@@ -32,13 +32,13 @@ The
.Nm
configuration file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr iscsid 8 .
.It Sy Target Configuration
.It Sx Target configuration
Target-specific parameters.
.El
.Pp
@@ -64,7 +64,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/iscsi-target.conf"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -86,7 +86,7 @@ target "disk1" {
targetaddr $target1
}
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
There are a few settings that affect the operation of the
.Xr iscsid 8
daemon globally.
@@ -128,7 +128,7 @@ and a 16-bit
.Ar qual
qualifier.
.El
.Sh TARGET CONFIGURATION
.Ss Target configuration
.Xr iscsid 8
establishes TCP connections to iSCSI targets.
Each target is specified by a

32
usr.sbin/ldpd/ldpd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ldpd.conf.5,v 1.43 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: ldpd.conf.5,v 1.44 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2013, 2016 Renato Westphal <renato@openbsd.org>
.\" Copyright (c) 2009 Michele Marchetto <michele@openbsd.org>
@@ -19,7 +19,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt LDPD.CONF 5
.Os
.Sh NAME
@@ -34,21 +34,21 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ldpd 8 .
.It Sy Address-Family Configuration
.It Sx Address-family configuration
Address-family specific parameters.
.It Sy Interfaces Configuration
.It Sx Interfaces configuration
Interface-specific parameters.
.It Sy Targeted Neighbors Configuration
.It Sx Targeted neighbors configuration
Targeted neighbor specific parameters.
.It Sy Neighbors Configuration
.It Sx Neighbors configuration
Neighbor-specific parameters.
.It Sy Layer 2 VPNs Configuration
.It Sx Layer 2 VPNs configuration
Layer 2 VPNs parameters as per RFC 4447.
.El
.Pp
@@ -61,7 +61,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/ldpd.sub.conf"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -73,7 +73,7 @@ Within unquoted arguments, the string
.Pf $ Ar name
is later expanded to
.Ar value .
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
Several settings can be configured globally or within a more restricted scope,
like per address-family or per interface.
The only settings that can be set globally and not overruled are listed below.
@@ -142,7 +142,7 @@ be established.
The default is
.Ic ipv6 .
.El
.Sh ADDRESS-FAMILY CONFIGURATION
.Ss Address-family configuration
Each address-family can have several parameters configured
individually, otherwise they are inherited.
.Bd -literal -offset indent
@@ -208,7 +208,7 @@ Set the local address to be used in the TCP sessions.
For the IPv4 address-family, the router-id will be used if this option is not specified.
For the IPv6 address-family, this option must be specified.
.El
.Sh INTERFACES
.Ss Interfaces configuration
Each interface can have several parameters configured individually, otherwise
they are inherited.
.Bd -literal -offset indent
@@ -233,7 +233,7 @@ The default value is 15; valid range is 3\-65535.
Set the hello interval in seconds.
The default value is 5; valid range is 1\-65535.
.El
.Sh TARGETED NEIGHBORS
.Ss Targeted neighbors configuration
Each targeted neighbor can have several parameters configured individually,
otherwise they are inherited.
.Bd -literal -offset indent
@@ -261,7 +261,7 @@ The default value is 45.
Set the hello interval in seconds.
The default value is 5; valid range is 1\-65535.
.El
.Sh NEIGHBORS
.Ss Neighbors configuration
The
.Ic neighbor
section allows for the configuration of neighbor-specific parameters.
@@ -300,7 +300,7 @@ Enable TCP MD5 signatures per RFC 5036 with the specified hexadecimal key.
.It Ic no tcp md5sig
Disable the use of TCP MD5 signatures.
.El
.Sh LAYER 2 VPNS
.Ss Layer 2 VPNs configuration
.Xr ldpd 8
implements the signaling of pseudowires which can be used to
implement either the VPWS solution (also known as PWE3) or the VPLS

32
usr.sbin/npppd/npppd/npppd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: npppd.conf.5,v 1.35 2024/07/11 14:05:59 yasuoka Exp $
.\" $OpenBSD: npppd.conf.5,v 1.36 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2012 YASUOKA Masahiko <yasuoka@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 11 2024 $
.Dd $Mdocdate: July 8 2025 $
.Dt NPPPD.CONF 5
.Os
.Sh NAME
@@ -29,22 +29,22 @@ is the configuration file for the PPP daemon
is divided into the following main sections:
.Pp
.Bl -tag -width "AuthenticationXXX" -offset indent -compact
.It Sy Global
.It Sx Global
Global settings.
.It Sy Tunnel
.It Sx Tunnel
Tunneling protocol and PPP settings.
.It Sy IPCP
.It Sx IPCP
Internet Protocol Configuration Protocol (IPCP) of PPP.
.It Sy Interface
.It Sx Interface
Interface settings.
.It Sy Authentication
.It Sx Authentication
Authentication settings.
.It Sy Bind
.It Sx Bind
Bind settings.
.It Sy RADIUS
.It Sx RADIUS
RADIUS settings.
.El
.Sh GLOBAL
.Ss Global
The global options are as follows:
.Bl -tag -width Ds
.It Ic set max-session Ar number
@@ -58,7 +58,7 @@ Specify the maximum number of sessions for each user.
means no limit.
The default value is 0.
.El
.Sh TUNNEL
.Ss Tunnel
The
.Ic tunnel
setting is described below:
@@ -474,7 +474,7 @@ dumps sent PPPoE session packets for debug.
The default is
.Dq no .
.El
.Sh IPCP
.Ss IPCP
The
.Ic ipcp
setting is described below:
@@ -536,7 +536,7 @@ setting.
means no limit.
The default value is 0.
.El
.Sh INTERFACE
.Ss Interface
The
.Ic interface
setting is described below:
@@ -559,7 +559,7 @@ setting name that is used with this interface.
The maximum number of
.Ic interface
settings is 8.
.Sh AUTHENTICATION
.Ss Authentication
The
.Ic authentication
setting is described below:
@@ -655,7 +655,7 @@ Specify the maximum number of sessions for each user for this
.Ic authentication
setting.
.El
.Sh BIND
.Ss Bind
.Ic bind
describes a group of
.Ar tunnel ,
@@ -666,7 +666,7 @@ settings so that they are used together.
.Pp
.Ic bind tunnel from Ar tunnel Ic authenticated by Ar authentication
.Ic to Ar ifname
.Sh RADIUS
.Ss RADIUS
.Ic radius
configures the RADIUS features.
The supported options are as follows:

18
usr.sbin/ospf6d/ospf6d.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ospf6d.conf.5,v 1.27 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: ospf6d.conf.5,v 1.28 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
@@ -17,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt OSPF6D.CONF 5
.Os
.Sh NAME
@@ -33,14 +33,14 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ospf6d 8 .
A number of global settings can be overruled in specific areas or interfaces.
.It Sy Areas
.It Sx Areas
An OSPF router must be a member of at least one area.
Areas are used to group interfaces, simplifying configuration.
.El
@@ -54,7 +54,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/ospf6d.sub.conf"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -82,7 +82,7 @@ area 0.0.0.0 {
.Pp
The same can be accomplished by specifying the hello-interval
globally or within the area declaration.
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
All interface related settings can be configured globally, per area and per
interface.
The only settings that can be set globally and not overruled are listed below.
@@ -237,7 +237,7 @@ variable
.Va net.inet6.ip6.forwarding
is set to a value different to 1 or if the FIB is not coupled.
.El
.Sh AREAS
.Ss Areas
Areas are used for grouping interfaces.
All interface-specific parameters can
be configured per area, overruling the global settings.
@@ -278,7 +278,7 @@ see the
keyword in
.Xr ifconfig 8 .
.El
.Sh INTERFACES
.Ss Interfaces
Each interface can have several parameters configured individually, otherwise
they are inherited.
An interface is specified by its name.

18
usr.sbin/ospfd/ospfd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ospfd.conf.5,v 1.65 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: ospfd.conf.5,v 1.66 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
.\" Copyright (c) 2004 Claudio Jeker <claudio@openbsd.org>
@@ -17,7 +17,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt OSPFD.CONF 5
.Os
.Sh NAME
@@ -33,14 +33,14 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ospfd 8 .
A number of global settings can be overruled in specific areas or interfaces.
.It Sy Areas
.It Sx Areas
An OSPF router must be a member of at least one area.
Areas are used to group interfaces, simplifying configuration.
.El
@@ -54,7 +54,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/ospfd.sub.conf"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -82,7 +82,7 @@ area 0.0.0.0 {
.Pp
The same can be accomplished by specifying the hello-interval
globally or within the area declaration.
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
All interface related settings can be configured globally, per area and per
interface.
The only settings that can be set globally and not overruled are listed below.
@@ -257,7 +257,7 @@ variable
.Va net.inet.ip.forwarding
is set to a value other than 1 or if the FIB is not coupled.
.El
.Sh AREAS
.Ss Areas
Areas are used for grouping interfaces.
All interface-specific parameters can
be configured per area, overruling the global settings.
@@ -311,7 +311,7 @@ enabled by specifying the default redistribute option.
A default summary LSA will only be redistributed if the router has an active
connection to the backbone area 0.0.0.0.
.El
.Sh INTERFACES
.Ss Interfaces
Each interface can have several parameters configured individually, otherwise
they are inherited.
An interface is specified by its name.

16
usr.sbin/rad/rad.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: rad.conf.5,v 1.30 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: rad.conf.5,v 1.31 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2018 Florian Obser <florian@openbsd.org>
.\" Copyright (c) 2005 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt RAD.CONF 5
.Os
.Sh NAME
@@ -33,10 +33,10 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr rad 8 .
These are used as default values for
@@ -44,7 +44,7 @@ These are used as default values for
definitions and can be overwritten in an
.Ic interface
block.
.It Sy Interfaces
.It Sx Interfaces
.Xr rad 8
sends IPv6 router advertisement messages.
This section defines on which interfaces to advertise prefix information
@@ -54,7 +54,7 @@ and their associated parameters.
Additional configuration files can be included with the
.Ic include
keyword.
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -66,7 +66,7 @@ Within unquoted arguments, the string
.Pf $ Ar name
is later expanded to
.Ar value .
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
The global configuration section sets defaults for router advertisement
messages.
These can be overwritten in interface blocks.
@@ -147,7 +147,7 @@ communicate the link-layer address of the sending interface.
The default is
.Cm yes .
.El
.Sh INTERFACES
.Ss Interfaces
A list of interfaces or interface groups to send advertisements on:
.Bl -tag -width Ds
.It Ic interface Ar name Op Brq Ar prefix ...

66
usr.sbin/relayd/relayd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: relayd.conf.5,v 1.212 2025/07/07 20:56:48 schwarze Exp $
.\" $OpenBSD: relayd.conf.5,v 1.213 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2006 - 2016 Reyk Floeter <reyk@openbsd.org>
.\" Copyright (c) 2006, 2007 Pierre-Yves Ritschard <pyr@openbsd.org>
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt RELAYD.CONF 5
.Os
.Sh NAME
@@ -29,33 +29,33 @@ is the configuration file for the relay daemon,
.Nm
is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr relayd 8 .
Do note that the config file allows global settings to be added after
defining tables in the config file, but those tables will use the
built-in defaults instead of the global settings below them.
.It Sy Tables
.It Sx Tables
Table definitions describe a list of hosts,
in a similar fashion to
.Xr pf 4
tables.
They are used for relay, redirection, and router target selection with
the described options and health checking on the host they contain.
.It Sy Redirections
.It Sx Redirections
Redirections are translated to
.Xr pf 4
rdr-to rules for stateful forwarding to a target host from a
health-checked table on layer 3.
.It Sy Relays
.It Sx Relays
Relays allow application layer load balancing, TLS acceleration, and
general purpose TCP proxying on layer 7.
.It Sy Protocols
.It Sx Protocols
Protocols are predefined settings and filter rules for relays.
.It Sy Routers
.It Sx Routers
Routers are used to insert routes with health-checked gateways for
(WAN) link balancing.
.El
@@ -95,7 +95,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/relayd.conf.local"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -120,7 +120,7 @@ table <webhosts> {
$www2
}
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
Here are the settings that can be set globally:
.Bl -tag -width Ds
.It Ic agentx Oo Ic context Ar context Oc Oo Ic path Ar path Oc
@@ -189,7 +189,7 @@ same collision domain \(en use a higher timeout, such as 1000 milliseconds,
for checks of hosts in other subnets.
If this option is to be set, it should be placed before overrides in tables.
.El
.Sh TABLES
.Ss Tables
Tables are used to group a set of hosts as the target for redirections
or relays; they will be mapped to a
.Xr pf 4
@@ -253,9 +253,9 @@ Tables are used by
directives in redirections or relays with a set of general options,
health-checking rules, and timings;
see the
.Sx REDIRECTIONS
.Sx Redirections
and
.Sx RELAYS
.Sx Relays
sections for more information about the forward context.
Table specific configuration directives are described below.
Multiple options can be appended to
@@ -441,7 +441,7 @@ IP address and port of the relay.
Additional input can be fed into the
hash by looking at HTTP headers and GET variables;
see the
.Sx PROTOCOLS
.Sx Protocols
section below.
This mode is only supported by relays.
.It Ic mode least-states
@@ -483,7 +483,7 @@ or as a string.
If omitted,
.Xr relayd 8
generates a random key when the configuration is loaded.
.Sh REDIRECTIONS
.Ss Redirections
Redirections represent a
.Xr pf 4
rdr-to rule.
@@ -507,7 +507,7 @@ It can be later enabled through
.Ar options ...
.Xc
Specify the tables of target hosts to be used; see the
.Sx TABLES
.Sx Tables
section above for information about table options.
If the
.Ic port
@@ -599,7 +599,7 @@ for an rdr-to rule in
It will ensure that multiple connections from the same source are
mapped to the same redirection address.
.El
.Sh RELAYS
.Ss Relays
Relays will forward traffic between a client and a target server.
In contrast to redirections and IP forwarding in the network stack, a
relay will accept incoming connections from remote clients as a
@@ -682,7 +682,7 @@ more times.
.Xc
Like the previous directive, but connect to a host from the specified
table; see the
.Sx TABLES
.Sx Tables
section above for information about table options.
This directive can be specified multiple times \(en subsequent entries
will be used as the backup table if all hosts in the previous table
@@ -729,14 +729,14 @@ encrypted TLS protocol.
Use the specified protocol definition for the relay.
The generic TCP protocol options will be used by default;
see the
.Sx PROTOCOLS
.Sx Protocols
section below.
.It Ic session timeout Ar seconds
Specify the inactivity timeout in seconds for accepted sessions.
The default timeout is 600 seconds (10 minutes).
The maximum is 2147483647 seconds (68 years).
.El
.Sh TLS RELAYS
.Ss TLS relays
In addition to plain TCP,
.Xr relayd 8
supports the Transport Layer Security (TLS) cryptographic protocol for
@@ -758,7 +758,7 @@ of plain TCP connections.
See the
.Ic forward to
description in the
.Sx RELAYS
.Sx Relays
section for more details.
.It Ic TLS server
When specifying the
@@ -773,7 +773,7 @@ This mode is also known as
See the
.Ic listen on
description in the
.Sx RELAYS
.Sx Relays
section for more details.
.It Ic TLS client and server
When combining both modes, TLS server and client,
@@ -785,7 +785,7 @@ The configuration requires additional X.509 certificate settings;
see the
.Ic ca key
description in the
.Sx PROTOCOLS
.Sx Protocols
section for more details.
.El
.Pp
@@ -810,7 +810,7 @@ validation attributes.
Now it finally accepts the TLS connection from the diverted client
using the updated certificate and continues to handle the connection
and to connect to the remote server.
.Sh PROTOCOLS
.Ss Protocols
Protocols are templates defining settings and rules for relays.
They allow setting generic TCP options, TLS settings, and rules
for the selected application layer protocol.
@@ -848,7 +848,7 @@ The available configuration directives are described below:
Specify one or more rules to filter connections based on their
network or application layer headers;
see the
.Sx FILTER RULES
.Sx Filter rules
section for more details.
.It Ic return error Op Ar option
Return an error response to the client if an internal operation or the
@@ -1063,7 +1063,7 @@ The default is
.Ic no websockets .
.El
.El
.Sh FILTER RULES
.Ss Filter rules
Relays have the ability to filter connections based
on their network or application layer headers.
Filter rules apply options to connections based on the specified
@@ -1144,7 +1144,7 @@ With this option, requests can be passed to specific backend servers.
A corresponding
.Ic forward to
declaration in the
.Sx RELAYS
.Sx Relays
section is required.
.It Ic label Ar string
The label will be printed as part of the error message if the
@@ -1391,7 +1391,7 @@ target host.
See the
.Ic table
keyword in the
.Sx RELAYS
.Sx Relays
section above.
.It Ic log
Log the
@@ -1420,7 +1420,7 @@ as detailed for the
.Ic append
directive above.
.El
.Sh ROUTERS
.Ss Routers
Routers represent routing table entries in the kernel forwarding
database, see
.Xr route 4 ,
@@ -1460,7 +1460,7 @@ context are described below:
.Ar options ...
.Xc
Specify the table of target gateways to be used; see the
.Sx TABLES
.Sx Tables
section above for information about table options.
This entry is mandatory and must be specified once.
.It Xo
@@ -1617,7 +1617,7 @@ relay "sshforward" {
The following relay example will configure
.Dq TLS inspection
as described in the
.Sx TLS RELAYS
.Sx TLS relays
section.
To start, first generate a new local CA key and certificate:
.Bd -literal -offset indent
@@ -1629,7 +1629,7 @@ A TLS server key and self-signed cert for 127.0.0.1 are also required;
see
.Ic listen on
in the
.Sx RELAYS
.Sx Relays
section for more details about certificate locations.
Configure the packet filter with a matching divert rule in
.Xr pf.conf 5 :

16
usr.sbin/ripd/ripd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ripd.conf.5,v 1.22 2025/07/07 20:56:49 schwarze Exp $
.\" $OpenBSD: ripd.conf.5,v 1.23 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2006 Michele Marchetto <mydecay@openbeer.it>
.\" Copyright (c) 2005, 2006 Esben Norby <norby@openbsd.org>
@@ -18,7 +18,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt RIPD.CONF 5
.Os
.Sh NAME
@@ -34,16 +34,16 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ripd 8 .
.It Sy Interfaces Configuration
.It Sx Interfaces configuration
Interface-specific parameters.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -63,7 +63,7 @@ interface em0 {
cost $hi
}
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
Global settings concerns the main behaviour of the daemon.
.Pp
.Bl -tag -width Ds -compact
@@ -157,7 +157,7 @@ Immediately trigger responses when a route changes.
The default is
.Ic no .
.El
.Sh INTERFACES
.Ss Interfaces configuration
Each interface can have several parameters configured individually, otherwise
they are inherited.
.Bd -literal -offset indent

20
usr.sbin/snmpd/snmpd.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: snmpd.conf.5,v 1.65 2025/07/07 20:56:49 schwarze Exp $
.\" $OpenBSD: snmpd.conf.5,v 1.66 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2007, 2008, 2012 Reyk Floeter <reyk@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt SNMPD.CONF 5
.Os
.Sh NAME
@@ -30,15 +30,15 @@ The
.Nm
file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global runtime settings for
.Xr snmpd 8 .
.It Sy User Configuration
.It Sx User configuration
USM user definitions.
.It Sy OID Configuration
.It Sx OID configuration
Custom configuration of SNMP object identifiers and values.
.El
.Pp
@@ -59,7 +59,7 @@ keyword, for example:
.Bd -literal -offset indent
include "/etc/snmpd.conf.local"
.Ed
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -80,7 +80,7 @@ For example:
ext_addr="192.168.0.1"
listen on $ext_addr
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
The following options can be set globally:
.Bl -tag -width Ds
.It Ic blocklist Ar oid
@@ -377,7 +377,7 @@ option.
The IPv4 or IPv6 source address of the traps can be enforced using
.Ic source-address .
.El
.Sh USER CONFIGURATION
.Ss User configuration
Users for the SNMP User-based Security Model (USM, RFC 3414) must be
defined in the configuration file:
.Bl -tag -width xxxx
@@ -425,7 +425,7 @@ and defaults to
Any user account that has encryption enabled requires authentication to
be enabled too.
.El
.Sh OID CONFIGURATION
.Ss OID configuration
It is possible to specify user-defined OIDs in the configuration file:
.Bl -tag -width Ds
.It Xo

16
usr.sbin/ypldap/ypldap.conf.5
View File

@@ -1,4 +1,4 @@
.\" $OpenBSD: ypldap.conf.5,v 1.29 2025/07/07 20:56:49 schwarze Exp $
.\" $OpenBSD: ypldap.conf.5,v 1.30 2025/07/08 14:26:45 schwarze Exp $
.\"
.\" Copyright (c) 2008 Pierre-Yves Ritschard <pyr@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: July 7 2025 $
.Dd $Mdocdate: July 8 2025 $
.Dt YPLDAP.CONF 5
.Os
.Sh NAME
@@ -29,16 +29,16 @@ The
.Nm
config file is divided into the following main sections:
.Bl -tag -width xxxx
.It Sy Macros
.It Sx Macros
Definitions of variables that can be used later, simplifying the
configuration file.
.It Sy Global Configuration
.It Sx Global configuration
Global settings for
.Xr ypldap 8 .
.It Sy Directories
.It Sx Directories
LDAP Directory specific parameters.
.El
.Sh MACROS
.Ss Macros
A macro is defined with a command of the form
.Ar name Ns = Ns Ar value .
The macro
@@ -57,7 +57,7 @@ fixed_gecos="Pulled from LDAP"
fixed attribute gecos $fixed_gecos
.Ed
.Sh GLOBAL CONFIGURATION
.Ss Global configuration
Global settings concern the main behaviour of the daemon.
.Pp
.Bl -tag -width Ds -compact
@@ -105,7 +105,7 @@ YP services are only available to the host running
.Xr ypldap 8 .
.El
.El
.Sh DIRECTORIES
.Ss Directories
Directories are used to describe the LDAP schema and help
.Xr ypldap 8
convert LDAP entries to