diff options
Diffstat (limited to 'share/man/man5')
28 files changed, 202 insertions, 200 deletions
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5 index 29512850d9e..147811fc908 100644 --- a/share/man/man5/a.out.5 +++ b/share/man/man5/a.out.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: a.out.5,v 1.13 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: a.out.5,v 1.14 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: a.out.5,v 1.8 1994/11/30 19:31:09 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -289,7 +289,7 @@ This type of relocation only occurs in shared objects. .It Fa r_copy If set, this relocation record identifies a symbol whose contents should be copied to the location given in -.Fa r_address. +.Fa r_address . The copying is done by the run-time link editor from a suitable data item in a shared object. .El diff --git a/share/man/man5/acct.5 b/share/man/man5/acct.5 index fc1e851b67c..6fb6bd3311a 100644 --- a/share/man/man5/acct.5 +++ b/share/man/man5/acct.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: acct.5,v 1.9 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: acct.5,v 1.10 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: acct.5,v 1.4 1995/10/22 01:40:10 ghudson Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -91,7 +91,7 @@ the name of the executed file (at most ten characters of it) is saved in the field .Fa ac_comm and its status is saved by setting one of more of the following flags in -.Fa ac_flag: +.Fa ac_flag : .Dv AFORK , .Dv ASU , .Dv ACOMPAT , diff --git a/share/man/man5/bsd.port.mk.5 b/share/man/man5/bsd.port.mk.5 index e5ea63397b5..8dc197239b6 100644 --- a/share/man/man5/bsd.port.mk.5 +++ b/share/man/man5/bsd.port.mk.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bsd.port.mk.5,v 1.89 2003/04/14 22:29:46 pvalchev Exp $ +.\" $OpenBSD: bsd.port.mk.5,v 1.90 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 2000 Marc Espie .\" @@ -83,9 +83,9 @@ will try to fetch a version with the correct checksum from the .Ox main archive site in the case of a checksum mismatch. .It Ar clean -Clean ports contents. +Clean ports contents. By default, it will clean the work directory. -It can be invoked as +It can be invoked as make clean='[depends bulk work fake flavors dist install sub package packages]'. .Bl -tag -width packages .It Va work @@ -259,7 +259,7 @@ port's variables without guessing wrongly. Update the packing lists for a port, using the fake installation and the existing packing lists. .Ar update-plist -should produce mostly correct +should produce mostly correct .Pa PLIST , .Pa PFRAG.shared and @@ -334,8 +334,8 @@ Defaults to ${WRKSRC}. Starting with .Ox 3.3 , several versions of autoconf may coexist peacefully. -Setting -.Ev AUTOCONF_VERSION +Setting +.Ev AUTOCONF_VERSION along with .Ev CONFIGURE_STYLE set to autoconf is the correct way to specify which one to use. @@ -348,7 +348,7 @@ Set based on corresponding INSTALL_* variables. .It Ev BIN_PACKAGES If set to .Sq Yes , -the +the .Ar package target will trust a package built in the repository to be up-to-date, and will not rebuild it if the work directory is absent. @@ -364,7 +364,7 @@ defaults to .Sq install if it is not specified. .Sq legacy -used to be a file to check. +used to be a file to check. The ports tree now uses .Sq pkgspec instead, as a package that must be installed prior to the build. @@ -378,16 +378,17 @@ is a comma separated list of flavors. By default, the dependency will build the default flavor. Build dependencies are checked at the beginning of the extract stage. .Pp -Build dependencies that are not the default -.Ar package or -.Ar install +Build dependencies that are not the default +.Ar package +or +.Ar install target will be processed in a subdirectory of the working directory, specifically, in ${WRKDIR}/directory. .It Ev BULK -If set to +If set to .Sq Yes , successful package builds and installations will clean -their working directories, after invoking +their working directories, after invoking .Ar ftp-packages , .Ar cdrom-packages , and any other targets mentioned in BULK_TARGETS. @@ -402,7 +403,7 @@ Used to store cookies for successful bulk-package builds, defaults to Flags to pass to build each target in .Ev BULK_TARGETS . .It Ev BULK_TARGETS -Targets to run after each bulk package build before cleaning up the +Targets to run after each bulk package build before cleaning up the working directory. Defaults to .Ar ftp-packages , @@ -461,7 +462,9 @@ Comment used for a sub-, flavored package. .It Ev COMES_WITH The first release where the port was made part of the standard distribution. -If the current OpenBSD version is >= this version then a notice +If the current +.Ox +version is >= this version then a notice will be displayed instead of the port being built. .It Ev CONFIGURE_ARGS Arguments to pass to configure script. @@ -478,7 +481,7 @@ Should be relative to ${WRKSRC}. .It Ev CONFIGURE_SHARED Set to --enable-shared or --disable-shared, depending on whether the architecture supports shared libraries. -Should be appended to CONFIGURE_ARGS, for ports that build dynamic libraries +Should be appended to CONFIGURE_ARGS, for ports that build dynamic libraries and whose configure script supports these options. .It Ev CONFIGURE_STYLE Set to style of configuration that needs to happen. @@ -498,7 +501,7 @@ if port does not handle DESTDIR correctly, and needs to be configured to add DESTDIR to prefixes .Po see also -.Ev DESTDIRNAME +.Ev DESTDIRNAME .Pc . Add .Sq old @@ -540,7 +543,7 @@ Don't override. Name of variable to set to ${WRKINST} while faking. Usually DESTDIR. To be used in the rare cases where a port heeds DESTDIR in a few -directories and needs to be configured with +directories and needs to be configured with .Sq gnu dest , so that those few directories do not get in the way. .It Ev DISTDIR @@ -713,7 +716,7 @@ which is a comma-separated list of .Sq lib_spec of the form: .Sq libname.[version.[subversion]] . -See +See .Xr library-specs 7 for more details. .Pp @@ -760,11 +763,11 @@ Environment variables passed to make invocations. Sets at least PATH, PREFIX, LOCALBASE, X11BASE, CFLAGS, TRUEPREFIX, DESTDIR, and the BSD_INSTALL_* macros. .It Ev MAKE_FLAGS -Flags used for all make invocations, except for the -.Ar fake +Flags used for all make invocations, except for the +.Ar fake stage, which uses .Ev FAKE_FLAGS , -and for the regress stage, which uses +and for the regress stage, which uses .Ev REGRESS_FLAGS . .It Ev MAKE_FILE Name of the Makefile used for ports building. @@ -852,13 +855,13 @@ Suffix used by .Ar patch to rename original files, and .Ar update-patches -to re-generate +to re-generate .Pa ${PATCHDIR}/${PATCH_LIST} by looking for files using this suffix. Defaults to .Pa .orig . -For a port that already contains -.Pa .orig +For a port that already contains +.Pa .orig files in the ${DISTFILES}, set this to something else, such as .Pa .pat.orig . @@ -926,7 +929,7 @@ Defaults to -p0 . .It Ev PATCH_LIST Wildcard pattern of patches to select under ${PATCHDIR} (default: patch-*). Note that filenames ending in .orig, or ~ are never applied. -Note that +Note that .Ev PATCH_LIST can hold absolute pathnames, for instance to share patches among similar ports: @@ -972,7 +975,7 @@ Default is The first cipher that matches in ${CHECKSUM_FILE} is verified. .It Ev PREFIX Base directory for the current port installation. -Usually ${LOCALBASE}, though some ports may elect a location under +Usually ${LOCALBASE}, though some ports may elect a location under .Pa /var , and some multi-package ports may install under several locations. .It Ev PSEUDO_FLAVORS @@ -980,7 +983,7 @@ Extra list of flavors that do not register in package names, but are still used to control build logic, and e.g., working directory names. Its main use is for disabling part of a multi-packages build, for instance: .Bd -literal -FLAVOR=no_gnome make package +FLAVOR=no_gnome make package .Ed .Pp Creation of a separate working directory is mandatory. @@ -990,13 +993,13 @@ all the work will need to be done again. If set to true, .Ar checksum will analyze ${CHECKSUM_FILE}, and try retrieving files with the correct -checksum off +checksum off .Pa ftp.openbsd.org , in the directory .Pa /pub/OpenBSD/distfiles/$cipher/$value/$file . .It Ev REGRESS_DEPENDS See -.Ev BUILD_DEPENDS +.Ev BUILD_DEPENDS for specification. Regress dependencies are only checked if the regress stage is invoked. .It Ev REGRESS_FLAGS @@ -1010,12 +1013,12 @@ if port needs human interaction to run its tests. Target to run regression tests. Defaults to .Sq regress , -except for +except for .Sq perl -and -.Sq gnu +and +.Sq gnu .Ev CONFIGURE_STYLE , -which default to +which default to .Sq test and .Sq check @@ -1169,17 +1172,17 @@ if port requires lesstif to work; if ports requires openmotif to work. The .Sq any -setting creates an extra flavor choice of +setting creates an extra flavor choice of .Sq lesstif . .It Ev USE_X11 Set to .Sq Yes if port requires X11 to work. .It Ev VMEM_WARNING -Set to -.Sq Yes +Set to +.Sq Yes if the port requires a lot of memory to compile, and the user is -likely to see a message like +likely to see a message like .Qq virtual memory exhausted with the default process limits. .It Ev XMKMF @@ -1310,9 +1313,9 @@ Used to organize a collection of ports that share most files. uses a single port with flavors or multi-packages to produce package variations instead. .It Ev MASTER_SITE_SUBDIR -Contents were used to replace +Contents were used to replace .Sq %SUBDIR% -in all +in all .Ev MASTER_SITES variables. Since @@ -1320,10 +1323,10 @@ Since almost always occur at the end of the directory, the simpler .Li ${VARIABLE:=subdir/} -construct is now used instead -.Po +construct is now used instead +.Po taken from -.Nx +.Nx .Pc . .It Ev MD5_FILE Use @@ -1393,7 +1396,7 @@ is no longer useful. used to be retrieved from a separate site list. For greater flexibility, all files are now retrieved from .Ev MASTER_SITES , -.Ev MASTER_SITES0 , ..., +.Ev MASTER_SITES0 , ... , .Ev MASTER_SITES9 , using a .Sq :0 @@ -1420,7 +1423,7 @@ It is not recommended to try to access them directly. .It Ev PKGNAME Used to refer to the full package name, has been superseded by .Ev FULLPKGNAME-foo , -for +for .Ev SUBPACKAGE -foo . .Ev PKGNAME @@ -1467,9 +1470,9 @@ was used. .It Pa /usr/share/mk/bsd.port.mk Original location of .Nm bsd.port.mk . -The current file lives under +The current file lives under .Pa ${PORTSDIR}/infrastructure/mk/bsd.port.mk , -whereas +whereas .Pa /usr/share/mk/bsd.port.mk is just a stub. .It Pa {scripts,files,patches}.${OPSYS} @@ -1516,7 +1519,7 @@ For instance, a few ports may need supplementary stuff to be present (as it would be installed if the ports' dependencies were present). .Pp If {pre,do,post}-install overrides are present, they are used with some -important changes: PREFIX is set to ${WRKINST}${PREFIX}, ${DESTDIRNAME} +important changes: PREFIX is set to ${WRKINST}${PREFIX}, ${DESTDIRNAME} is set to ${WRKINST}, and TRUEPREFIX is set to ${PREFIX}. Essentially, old install targets work transparently, except for a need to change PREFIX to TRUEPREFIX for symbolic links and similar path lookups. @@ -1532,7 +1535,7 @@ If no do-install override is present, the port is installed using .Ed .Pp Note that this does set both PREFIX and ${DESTDIRNAME}. -If a port's Makefile both heeds ${DESTDIRNAME}, +If a port's Makefile both heeds ${DESTDIRNAME}, and references PREFIX explicitly, FAKE_FLAGS may rectify the problem by setting PREFIX=${PREFIX} (which will do the right thing, since ${PREFIX} is a @@ -1586,7 +1589,7 @@ If a port can generate several useful packages, set MULTI_PACKAGES accordingly. Each extension of a MULTI_PACKAGES name should start with a dash, so that they cannot be confused with FLAVORS. -In dependency checking and recursive builds, a subpackage can be +In dependency checking and recursive builds, a subpackage can be specified after a comma, e.g., SUBDIR+=quake,-server. MULTI_PACKAGES only affects the actual package building step (and the describe step, since a MULTI_PACKAGES port will produce several @@ -1609,7 +1612,7 @@ Run env SUBPACKAGE=-server PACKAGING=-server make package, .Pp The port's Makefile can test the value of SUBPACKAGE to specialize processing for all sub packages. -Note that SUBPACKAGE can also be set for dependency checking, so be +Note that SUBPACKAGE can also be set for dependency checking, so be careful to also test PACKAGING: the build stage is shared among all subpackages, and tests often only make sense during the packaging stage. All packing information is derived from @@ -1685,15 +1688,15 @@ to register directories that hold dynamic libraries (see .Xr ldconfig 8 ) . .Li "NEWDYNLIBDIR" is meant for directories that will go away when the package is deleted. -If possible, it should not be used, because users also have to edit +If possible, it should not be used, because users also have to edit .Pa rc.conf -to add the directory. -It is usually better to also let libraries be visible as a link +to add the directory. +It is usually better to also let libraries be visible as a link under ${LOCALBASE}. Having a separate directory is enough to trick .Xr ld 1 into grabbing the right version. -Note that libraries used only for +Note that libraries used only for .Xr dlopen 3 do not need NEWDYNLIBDIR. .Pp @@ -1708,14 +1711,9 @@ DEINSTALL files in a similar way). This contrasts with the FLAVORS situation, where all these files will automatically default to the non-flavor version if there is no flavor-specific file around. -.Sh BUGS AND LIMITATIONS -.Ev LOCALBASE , -.Ev X11BASE -and -.Ev PREFIX -are not heeded consistently. -Most of the ports tree will probably fall -apart if one tries to build/use stuff elsewhere. +.Sh SEE ALSO +.Xr library-specs 7 , +.Xr packages-specs 7 .Sh HISTORY The ports mechanism originally came from .Fx . @@ -1731,6 +1729,11 @@ FLAVORS, MULTI_PACKAGES and FAKE are improvements. .\" Voluntarily undocumented: .\" AUTOCONF_ENV: probably not needed anyway, should be internal. -.Sh SEE ALSO -.Xr library-specs 7 , -.Xr packages-specs 7 +.Sh BUGS AND LIMITATIONS +.Ev LOCALBASE , +.Ev X11BASE +and +.Ev PREFIX +are not heeded consistently. +Most of the ports tree will probably fall +apart if one tries to build/use stuff elsewhere. diff --git a/share/man/man5/bsd.regress.mk.5 b/share/man/man5/bsd.regress.mk.5 index 6a370f8ffe6..e9b558c8b5b 100644 --- a/share/man/man5/bsd.regress.mk.5 +++ b/share/man/man5/bsd.regress.mk.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: bsd.regress.mk.5,v 1.3 2002/09/02 19:56:55 avsm Exp $ +.\" $OpenBSD: bsd.regress.mk.5,v 1.4 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 2002 Anil Madhavapeddy .\" Copyright (c) 2000 Marc Espie @@ -56,7 +56,7 @@ Executes all of the regression targets defined in the Makefile. Runs an individual regression test. If the exit status of the program indicates an error or timeout, then a failure is logged, otherwise the test is marked as a success. -.El +.El .Sh VARIABLES .Bl -tag -width REGRESS_LOG .It Ev REGRESS_LOG @@ -75,36 +75,36 @@ variable is invoked for these targets. See also .Ev SUDO . .It Ev REGRESS_SKIP_SLOW -If this variable is not empty, skip over all the regression +If this variable is not empty, skip over all the regression tests which have been marked as being 'slow' using the .Ev REGRESS_SLOW_TARGETS variable. .It Ev REGRESS_SLOW_TARGETS Targets which are defined as 'slow'. -All of these tests can be skipped by setting the -.Ev REGRESS_SKIP_SLOW +All of these tests can be skipped by setting the +.Ev REGRESS_SKIP_SLOW variable. .It Ev REGRESS_TARGETS Targets which are invoked to run the set of regression tests for this Makefile. -Defaults to +Defaults to .Ar run-regress-${PROG} . .It Ev SUDO Location of the sudo command, used to switch to root for certain test targets which require it. .El -.Sh BUGS AND LIMITATIONS -The build system is unable to distinguish between timeouts due to -.Ev REGRESS_MAXTIME -being exceeded, or a genuine failure occurring. +.Sh SEE ALSO +.Xr bsd.port.mk 5 .Sh HISTORY The regression system originally came from .Nx , with many tests added by -.Ox +.Ox since. The current Makefile framework was written by Artur Grabowski -and Marc Espie for +and Marc Espie for .Ox 3.1 . -.Sh SEE ALSO -.Xr bsd.port.mk 5 +.Sh BUGS AND LIMITATIONS +The build system is unable to distinguish between timeouts due to +.Ev REGRESS_MAXTIME +being exceeded, or a genuine failure occurring. diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5 index 1950bd10d8b..6a82670be4e 100644 --- a/share/man/man5/elf.5 +++ b/share/man/man5/elf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: elf.5,v 1.8 2003/04/14 06:51:49 jmc Exp $ +.\" $OpenBSD: elf.5,v 1.9 2003/06/06 13:28:13 jmc Exp $ .\"Copyright (c) 1999 Jeroen Ruigrok van der Werven .\"All rights reserved. .\" @@ -1350,5 +1350,5 @@ This manual page was written by .Aq asmodai@FreeBSD.org with inspiration from BSDi's .Bsx -.Xr elf 5 +.Nm elf manpage. diff --git a/share/man/man5/ethers.5 b/share/man/man5/ethers.5 index 6d136499edf..20aa54b3361 100644 --- a/share/man/man5/ethers.5 +++ b/share/man/man5/ethers.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ethers.5,v 1.13 2001/03/06 19:56:52 brad Exp $ +.\" $OpenBSD: ethers.5,v 1.14 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: ethers.5,v 1.2 1994/11/30 19:31:16 jtc Exp $ .\" .\" Written by Roland McGrath <roland@frob.com>. Public domain. @@ -36,6 +36,12 @@ file has support for YP functionality. .Sh SEE ALSO .Xr ethers 3 , .Xr diskless 8 +.Sh HISTORY +The +.Nm +file format was adopted from SunOS and appeared in +.Nx +0.9b. .Sh BUGS A name server should be used instead of a static file. .Pp @@ -45,9 +51,3 @@ are limited to .Dv BUFSIZE characters (currently 1024). Longer lines will be ignored. -.Sh HISTORY -The -.Nm -file format was adopted from SunOS and appeared in -.Nx -0.9b. diff --git a/share/man/man5/fbtab.5 b/share/man/man5/fbtab.5 index 589e8a510b7..30303aa208a 100644 --- a/share/man/man5/fbtab.5 +++ b/share/man/man5/fbtab.5 @@ -1,8 +1,8 @@ -.\" $OpenBSD: fbtab.5,v 1.11 2003/02/14 23:24:12 deraadt Exp $ -.\" +.\" $OpenBSD: fbtab.5,v 1.12 2003/06/06 13:28:13 jmc Exp $ +.\" .\" Copyright (c) 1996 Theo de Raadt .\" All rights reserved. -.\" +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -11,7 +11,7 @@ .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. -.\" +.\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5 index 3da269fe1f6..8628d30321b 100644 --- a/share/man/man5/forward.5 +++ b/share/man/man5/forward.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: forward.5,v 1.2 2001/09/11 17:45:47 marc Exp $ +.\" $OpenBSD: forward.5,v 1.3 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 2001 Marco S. Hyman .\" @@ -58,7 +58,7 @@ e-mail forwarding information .Rs .%T "Sendmail \- An Internetwork Mail Router" .%V SMM -.%N \&No. 9 +.%N \&No. 9 .Re .Rs .%T "Sendmail Installation and Operation Guide" diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5 index aac3e936cc3..552a964878d 100644 --- a/share/man/man5/fs.5 +++ b/share/man/man5/fs.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fs.5,v 1.11 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: fs.5,v 1.12 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: fs.5,v 1.3 1994/11/30 19:31:17 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -288,7 +288,7 @@ defines the amount of space allocated in the super-block for this name. The limit on the amount of summary information per file system is defined by -.Dv MAXCSBUFS. +.Dv MAXCSBUFS . For a 4096 byte block size, it is currently parameterized for a maximum of two million cylinders. .Pp diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5 index 7973d19ffa0..dcd7203cb5d 100644 --- a/share/man/man5/fstab.5 +++ b/share/man/man5/fstab.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fstab.5,v 1.26 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: fstab.5,v 1.27 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: fstab.5,v 1.5.2.1 1995/11/16 20:11:11 pk Exp $ .\" .\" Copyright (c) 1980, 1989, 1991, 1993 @@ -250,6 +250,10 @@ is to use the routines .Xr getfstype 3 , and .Xr getfsfile 3 . +.Sh FILES +.Bl -tag -width /etc/fstab -compact +.It Pa /etc/fstab +.El .Sh EXAMPLES Here is a sample .Pa /etc/fstab @@ -268,10 +272,6 @@ file: /proc /proc procfs rw 0 0 server:/export/ports /usr/ports nfs rw,nodev,nosuid,tcp,soft,intr 0 0 .Ed -.Sh FILES -.Bl -tag -width /etc/fstab -compact -.It Pa /etc/fstab -.El .Sh SEE ALSO .Xr quota 1 , .Xr getfsent 3 , diff --git a/share/man/man5/group.5 b/share/man/man5/group.5 index 94ec0efcca1..2e950ab0891 100644 --- a/share/man/man5/group.5 +++ b/share/man/man5/group.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: group.5,v 1.8 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: group.5,v 1.9 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: group.5,v 1.4 1995/07/28 06:41:39 phil Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -130,12 +130,6 @@ file itself, or included via YP, will be used. .Xr initgroups 3 , .Xr passwd 5 , .Xr yp 8 -.Sh BUGS -The -.Xr passwd 1 -command does not change the -.Nm -passwords. .Sh HISTORY A .Nm @@ -143,3 +137,9 @@ file format appeared in .At v6 . .Pp The YP file format first appeared in SunOS. +.Sh BUGS +The +.Xr passwd 1 +command does not change the +.Nm +passwords. diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5 index 618bf324c71..9c384da0342 100644 --- a/share/man/man5/hostname.if.5 +++ b/share/man/man5/hostname.if.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hostname.if.5,v 1.32 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: hostname.if.5,v 1.33 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -103,7 +103,7 @@ The above formats have the following field values: The address family of the interface, generally .Dq inet or -.Dq inet6. +.Dq inet6 . .It Va addr The optional address that belongs to the interface, such as 190.191.192.1 or fe80:2::1 . diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5 index e218e63d362..b4a9f9cc916 100644 --- a/share/man/man5/hosts.5 +++ b/share/man/man5/hosts.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hosts.5,v 1.13 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: hosts.5,v 1.14 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -61,7 +61,7 @@ databases to search; the databases currently known include .Xr yp 8 , DNS and the -.Xr hosts 5 +.Nm hosts database. .Pp When using the name server @@ -106,6 +106,11 @@ newline, or comment character. .Rs .%T "Name Server Operations Guide for BIND" .Re +.Sh HISTORY +The +.Nm +file format appeared in +.Bx 4.2 . .Sh BUGS A name server should be used instead of a static file. .Pp @@ -115,8 +120,3 @@ are limited to .Dv BUFSIZE characters (currently 1024). Longer lines will be ignored. -.Sh HISTORY -The -.Nm -file format appeared in -.Bx 4.2 . diff --git a/share/man/man5/login.conf.5 b/share/man/man5/login.conf.5 index bf2acf2cc01..7bf904f143d 100644 --- a/share/man/man5/login.conf.5 +++ b/share/man/man5/login.conf.5 @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: login.conf.5,v 1.28 2003/06/04 07:53:04 hin Exp $ +.\" $OpenBSD: login.conf.5,v 1.29 2003/06/06 13:28:13 jmc Exp $ .\" BSDI $From: login.conf.5,v 2.20 2000/06/26 14:50:38 prb Exp $ .\" .Dd June 18, 2001 @@ -337,7 +337,7 @@ or to the capability name (e.g., .Va openfiles-max and -.Va openfiles-cur Ns No ). +.Va openfiles-cur ) . .Pp \*(oSwill never define capabilities which start with .Li x- @@ -424,7 +424,7 @@ The authentication styles currently provided are: .Bl -tag -width kerberosxx .\" .It Li activ -Authenticate using an ActivCard token. +Authenticate using an ActivCard token. See .Xr login_activ 8 . .\" @@ -636,7 +636,7 @@ for the remote hostname. .It Li local_addr The local IP address given to .Xr login 1 -by the +by the .Fl L option. .It Li lastchance @@ -649,7 +649,7 @@ This is a new login session (as opposed to a simple identity check). .It Li remote_addr The remote IP address given to .Xr login 1 -by the +by the .Fl R option. .It Li style @@ -676,7 +676,7 @@ Some authentication types require the user to be in group wheel when using the .Xr su 1 program to become super user. -.El +.El .Pp When the authentication program is executed, the environment will only contain the values @@ -811,7 +811,7 @@ If this style of authentication does not support the service it should simply fail, complaining about an unknown service type. It should exit with a non-zero status. .Sh RESPONSES -When an authentication program is called with a service of +When an authentication program is called with a service of .Li response , and this style supports this mode of authentication, it should read two null terminated strings from file descriptor 3. diff --git a/share/man/man5/motd.5 b/share/man/man5/motd.5 index da7676a5b4d..382f3b32964 100644 --- a/share/man/man5/motd.5 +++ b/share/man/man5/motd.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: motd.5,v 1.6 2002/02/20 22:28:37 millert Exp $ +.\" $OpenBSD: motd.5,v 1.7 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: motd.5,v 1.2 1994/12/28 18:58:53 glass Exp $ .\" .\" This file is in the public domain. @@ -23,6 +23,10 @@ this file. Individual users may suppress the display of this file by creating a file named .Pa .hushlogin in their home directories. +.Sh FILES +.Bl -tag -width /etc/motd -compact +.It Pa /etc/motd +.El .Sh EXAMPLES .Bd -literal OpenBSD 3.0 (GENERIC) #5: Sat Jan 26 20:13:07 MST 2002 @@ -31,9 +35,5 @@ Make sure you have a .forward file... 4/17 Machine will be down for backups all day Saturday. .Ed -.Sh FILES -.Bl -tag -width /etc/motd -compact -.It Pa /etc/motd -.El .Sh SEE ALSO .Xr login 1 diff --git a/share/man/man5/netgroup.5 b/share/man/man5/netgroup.5 index b3b6d92e503..724df5a6a9e 100644 --- a/share/man/man5/netgroup.5 +++ b/share/man/man5/netgroup.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: netgroup.5,v 1.11 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: netgroup.5,v 1.12 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: netgroup.5,v 1.3 1995/03/18 14:58:34 cgd Exp $ .\" .\" Copyright (c) 1992, 1993 @@ -104,7 +104,7 @@ netgroup database .Xr getnetgrent 3 , .Xr exports 5 , .Xr netgroup_mkdb 8 -.Sh COMPATIBILITY +.Sh STANDARDS The file format is compatible with that of various vendors, although it appears that not all vendors use an identical format. .Sh BUGS diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5 index 9e4fade5d75..807acd28fcc 100644 --- a/share/man/man5/passwd.5 +++ b/share/man/man5/passwd.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: passwd.5,v 1.25 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: passwd.5,v 1.26 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: passwd.5,v 1.4 1995/07/28 06:46:05 phil Exp $ .\" .\" Copyright (c) 1988, 1991, 1993 @@ -266,12 +266,7 @@ containing: .Pp .%T "Managing NFS and NIS" (O'Reilly & Associates) -.Sh BUGS -User information should (and eventually will) be stored elsewhere. -.Pp -Placing YP exclusions in the file after any inclusions will have -unexpected results. -.Sh COMPATIBILITY +.Sh STANDARDS The password file format has changed since .Bx 4.3 . The following @@ -301,3 +296,8 @@ file format appeared in .At v3 . .Pp The YP file format first appeared in SunOS. +.Sh BUGS +User information should (and eventually will) be stored elsewhere. +.Pp +Placing YP exclusions in the file after any inclusions will have +unexpected results. diff --git a/share/man/man5/passwd.conf.5 b/share/man/man5/passwd.conf.5 index 1abca45317d..523f546a902 100644 --- a/share/man/man5/passwd.conf.5 +++ b/share/man/man5/passwd.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: passwd.conf.5,v 1.16 2002/11/24 20:46:40 millert Exp $ +.\" $OpenBSD: passwd.conf.5,v 1.17 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de> .\" All rights reserved. @@ -97,6 +97,10 @@ The default is 3. .Pp To retrieve information from this file use .Xr pw_getconf 3 . +.Sh FILES +.Bl -tag -width /etc/passwd.conf -compact +.It Pa /etc/passwd.conf +.El .Sh EXAMPLES Use blowfish as the local cipher; add some more rounds for root and wheel members. @@ -112,10 +116,6 @@ The old Unix crypt is used as YP cipher: :wheel: localcipher = blowfish,5 .Ed -.Sh FILES -.Bl -tag -width /etc/passwd.conf -compact -.It Pa /etc/passwd.conf -.El .Sh SEE ALSO .Xr passwd 1 , .Xr pw_getconf 3 , diff --git a/share/man/man5/phones.5 b/share/man/man5/phones.5 index 4df1d65c916..23478b462bf 100644 --- a/share/man/man5/phones.5 +++ b/share/man/man5/phones.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: phones.5,v 1.9 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: phones.5,v 1.10 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: phones.5,v 1.3 1994/11/30 19:31:25 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -89,13 +89,13 @@ looked up. Comments can be inserted into the file by making the first character on a line something not used to start any system name in the .Xr remote 5 -database(s) being used, such as +database(s) being used, such as .Ql # . .Pp Only one phone number per line is permitted. To associate more than one phone number with a system name you must create multiple lines that have the same system name. -.Xr tip 1 +.Xr tip 1 will try each number in sequence until it makes a connection or reaches the end of the file. .Sh FILES diff --git a/share/man/man5/protocols.5 b/share/man/man5/protocols.5 index 0417fbdd6e7..a0fab18806f 100644 --- a/share/man/man5/protocols.5 +++ b/share/man/man5/protocols.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: protocols.5,v 1.9 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: protocols.5,v 1.10 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: protocols.5,v 1.3 1994/11/30 19:31:27 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -65,6 +65,11 @@ field delimiter, newline, or comment character. .El .Sh SEE ALSO .Xr getprotoent 3 +.Sh HISTORY +The +.Nm +file format appeared in +.Bx 4.2 . .Sh BUGS A name server should be used instead of a static file. Lines in @@ -73,8 +78,3 @@ are limited to .Dv BUFSIZ characters (currently 1024). Longer lines will be ignored. -.Sh HISTORY -The -.Nm -file format appeared in -.Bx 4.2 . diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5 index 721268d4c34..1fea352d3af 100644 --- a/share/man/man5/remote.5 +++ b/share/man/man5/remote.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: remote.5,v 1.12 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: remote.5,v 1.13 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: remote.5,v 1.4 1997/04/20 00:05:27 mellon Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -278,7 +278,7 @@ in their dialing strings (hayes, courier, t3000) .Xr tip 1 will convert any .Ql \&= -in the string to a +in the string to a .Ql \&, when dialing. For modems or auto-call units that use a @@ -346,9 +346,9 @@ so that XON/XOFF flow control will be used to throttle data from the remote host. .It Sy \&tb (bool) -Initialize the -.Xr tip 1 -variable +Initialize the +.Xr tip 1 +variable .Dq tabexpand to .Sy on , diff --git a/share/man/man5/rpc.5 b/share/man/man5/rpc.5 index cbc5fce4c28..71c1086595d 100644 --- a/share/man/man5/rpc.5 +++ b/share/man/man5/rpc.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: rpc.5,v 1.6 2000/10/26 00:37:05 aaron Exp $ +.\" $OpenBSD: rpc.5,v 1.7 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: rpc.5,v 1.2 1994/11/30 19:31:30 jtc Exp $ .\" @(#)rpc.5 2.2 88/08/03 4.0 RPCSRC; from 1.4 87/11/27 SMI; .\" @@ -33,6 +33,10 @@ A hash mark .Pq Ql # indicates the beginning of a comment; subsequent characters up to the end of the line are not interpreted by the routines which search the file. +.Sh FILES +.Bl -tag -width /etc/rpc -compact +.It Pa /etc/rpc +.El .Sh EXAMPLES Here is an example of the .Pa /etc/rpc @@ -72,9 +76,5 @@ tfsd 100037 nsed 100038 nsemntd 100039 .Ed -.Sh FILES -.Bl -tag -width /etc/rpc -compact -.It Pa /etc/rpc -.El .Sh SEE ALSO .Xr getrpcent 3 diff --git a/share/man/man5/services.5 b/share/man/man5/services.5 index f85098fb42e..ed0fa1d455b 100644 --- a/share/man/man5/services.5 +++ b/share/man/man5/services.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: services.5,v 1.10 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: services.5,v 1.11 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: services.5,v 1.3 1994/11/30 19:31:31 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -70,6 +70,11 @@ field delimiter, newline, or comment character. .El .Sh SEE ALSO .Xr getservent 3 +.Sh HISTORY +The +.Nm +file format appeared in +.Bx 4.2 . .Sh BUGS A name server should be used instead of a static file. Lines in @@ -78,8 +83,3 @@ are limited to .Dv BUFSIZ characters (currently 1024). Longer lines will be ignored. -.Sh HISTORY -The -.Nm -file format appeared in -.Bx 4.2 . diff --git a/share/man/man5/spamd.conf.5 b/share/man/man5/spamd.conf.5 index 92cb8639a4c..06eb3380d69 100644 --- a/share/man/man5/spamd.conf.5 +++ b/share/man/man5/spamd.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: spamd.conf.5,v 1.10 2003/06/02 18:51:33 jason Exp $ +.\" $OpenBSD: spamd.conf.5,v 1.11 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 2003 Jason L. Wright (jason@thought.net) .\" Copyright (c) 2003 Bob Beck @@ -56,7 +56,7 @@ spews1:\e :black:\e :msg="SPAM. Your address \&%A is in the spews\e level 1 database\ensee http://www.spews.org/ask.cgi?x=\&%A\en":\e - :method=http:\e + :method=http:\e :file=www.spews.org/spews_list_level1.txt: white:\e @@ -183,7 +183,6 @@ The sequence %% will produce a single % in the output, and the sequence \&%A will be expanded in the message by .Xr spamd 8 to display the connecting IP address in the output. -.Pp .Sh SEE ALSO .Xr ftp 1 , .Xr pf 4 , diff --git a/share/man/man5/stab.5 b/share/man/man5/stab.5 index 116589b6b59..cbc0a833a23 100644 --- a/share/man/man5/stab.5 +++ b/share/man/man5/stab.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: stab.5,v 1.11 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: stab.5,v 1.12 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: stab.5,v 1.3 1994/11/30 19:31:33 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -215,10 +215,10 @@ compiled files: .Xr gdb 1 , .Xr ld 1 , .Xr a.out 5 -.Sh BUGS -More basic types are needed. .Sh HISTORY The .Nm file appeared in .Bx 4.0 . +.Sh BUGS +More basic types are needed. diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5 index 8e4894e2e04..3a1dfc1ebcf 100644 --- a/share/man/man5/sysctl.conf.5 +++ b/share/man/man5/sysctl.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sysctl.conf.5,v 1.7 2003/06/03 01:52:41 millert Exp $ +.\" $OpenBSD: sysctl.conf.5,v 1.8 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 1998 Todd C. Miller <Todd.Miller@courtesan.com> .\" @@ -34,6 +34,10 @@ variable assignments .Pq Ar variable Ns No = Ns Ar value with comments designated by a hash mark .Pq Sq # . +.Sh FILES +.Bl -tag -width /etc/sysctl.conf -compact +.It Pa /etc/sysctl.conf +.El .Sh EXAMPLES To turn on IP forwarding, one would use the following line: .Bd -literal -offset indent @@ -45,10 +49,6 @@ the debugger, the following can be used: .Bd -literal -offset indent ddb.panic=0 .Ed -.Sh FILES -.Bl -tag -width /etc/sysctl.conf -compact -.It Pa /etc/sysctl.conf -.El .Sh SEE ALSO .Xr rc 8 , .Xr sysctl 8 diff --git a/share/man/man5/utmp.5 b/share/man/man5/utmp.5 index 70d8fe96cc0..21e2fac52cb 100644 --- a/share/man/man5/utmp.5 +++ b/share/man/man5/utmp.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: utmp.5,v 1.19 2003/06/02 23:30:14 millert Exp $ +.\" $OpenBSD: utmp.5,v 1.20 2003/06/06 13:28:13 jmc Exp $ .\" $NetBSD: utmp.5,v 1.5 1994/11/30 19:31:35 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -181,16 +181,6 @@ character indicates the time prior to the change and the .Dq \&{ character indicates the new time. .El -.Sh CAVEATS -The strings in the -.Fa utmp -and -.Fa lastlog -structures are -.Em not -normal -.Sq C -strings and are thus not guaranteed to be null terminated. .Sh FILES .Bl -tag -width /var/log/lastlog -compact .It Pa /var/run/utmp @@ -214,3 +204,13 @@ The .Nm lastlog file format appeared in .Bx 3.0 . +.Sh CAVEATS +The strings in the +.Fa utmp +and +.Fa lastlog +structures are +.Em not +normal +.Sq C +strings and are thus not guaranteed to be null terminated. diff --git a/share/man/man5/wsconsctl.conf.5 b/share/man/man5/wsconsctl.conf.5 index 38f7c8b0aa0..5275d0fba09 100644 --- a/share/man/man5/wsconsctl.conf.5 +++ b/share/man/man5/wsconsctl.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: wsconsctl.conf.5,v 1.2 2001/08/25 20:25:33 mickey Exp $ +.\" $OpenBSD: wsconsctl.conf.5,v 1.3 2003/06/06 13:28:13 jmc Exp $ .\" .\" Copyright (c) 2001 Brian J. Kifiak <bk@rt.fm> .\" All rights reserved. @@ -49,6 +49,10 @@ variable assignments .Pq Ar variable Ns No = Ns Ar value with comments designated by a hash mark .Pq Sq # . +.Sh FILES +.Bl -tag -width /etc/wsconsctl.conf -compact +.It Pa /etc/wsconsctl.conf +.El .Sh EXAMPLES To load a Russian keyboard encoding, one would use the following line: .Bd -literal -offset indent @@ -59,10 +63,6 @@ To set the screen burner timeout to 60 seconds, the following can be used: .Bd -literal -offset indent display.screen_off=60000 .Ed -.Sh FILES -.Bl -tag -width /etc/wsconsctl.conf -compact -.It Pa /etc/wsconsctl.conf -.El .Sh SEE ALSO .Xr rc 8 , .Xr wsconsctl 8 |