simplify synopsis and text;
authorjmc <jmc@openbsd.org>
Fri, 16 Feb 2018 07:27:07 +0000 (07:27 +0000)
committerjmc <jmc@openbsd.org>
Fri, 16 Feb 2018 07:27:07 +0000 (07:27 +0000)
ok millert

sbin/sysctl/sysctl.8
sbin/sysctl/sysctl.c

index 0fc6ca7..c74a04d 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: sysctl.8,v 1.213 2018/01/12 04:36:44 deraadt Exp $
+.\"    $OpenBSD: sysctl.8,v 1.214 2018/02/16 07:27:07 jmc Exp $
 .\"    $NetBSD: sysctl.8,v 1.4 1995/09/30 07:12:49 thorpej Exp $
 .\"
 .\" Copyright (c) 1993
@@ -30,7 +30,7 @@
 .\"
 .\"    @(#)sysctl.8    8.2 (Berkeley) 5/9/95
 .\"
-.Dd $Mdocdate: January 12 2018 $
+.Dd $Mdocdate: February 16 2018 $
 .Dt SYSCTL 8
 .Os
 .Sh NAME
 .Nd get or set kernel state
 .Sh SYNOPSIS
 .Nm sysctl
-.Op Fl Aan
-.Nm sysctl
-.Op Fl n
-.Ar name ...
-.Nm sysctl
-.Op Fl nq
-.Ar name Ns = Ns Ar value ...
+.Op Fl Aanq
+.Op Ar name Ns Op = Ns Ar value
 .Sh DESCRIPTION
 The
 .Nm
@@ -53,7 +48,7 @@ appropriate privilege to set kernel state.
 The state to be retrieved or set is described using a
 .Dq Management Information Base
 .Pq MIB
-style name, described as a dotted set of components.
+style name, using a dotted set of components.
 .Pp
 When retrieving a variable,
 a subset of the MIB name may be specified to retrieve a list of
@@ -62,9 +57,6 @@ For example, to list all the machdep variables:
 .Pp
 .Dl $ sysctl machdep
 .Pp
-When setting a variable,
-the MIB name should be followed by an equal sign and the new value.
-.Pp
 The options are as follows:
 .Bl -tag -width xxx
 .It Fl A
@@ -86,11 +78,14 @@ For example, to set the psize shell variable to the pagesize of the hardware:
 Suppress all output when setting a variable.
 This option overrides the behaviour of
 .Fl n .
-.It Ar name Ns = Ns Ar value
-Attempt to set the specified variable
-.Ar name
-to
+.It Ar name Ns Op = Ns Ar value
+Retrieve the specified variable
+.Ar name ,
+or attempt to set it to
 .Ar value .
+Multiple
+.Ar name Ns Op = Ns Ar value
+arguments may be given.
 .El
 .Pp
 The information available from
index a0a18b0..47f8639 100644 (file)
@@ -1,4 +1,4 @@
-/*     $OpenBSD: sysctl.c,v 1.229 2018/02/10 05:53:58 florian Exp $    */
+/*     $OpenBSD: sysctl.c,v 1.230 2018/02/16 07:27:07 jmc Exp $        */
 /*     $NetBSD: sysctl.c,v 1.9 1995/09/30 07:12:50 thorpej Exp $       */
 
 /*
@@ -2723,8 +2723,6 @@ usage(void)
 {
 
        (void)fprintf(stderr,
-           "usage: sysctl [-Aan]\n"
-           "       sysctl [-n] name ...\n"
-           "       sysctl [-nq] name=value ...\n");
+           "usage: sysctl [-Aanq] [name[=value]]\n");
        exit(1);
 }