Changeset View
Changeset View
Standalone View
Standalone View
sbin/sysctl/sysctl.8
Show All 22 Lines | |||||||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||||||
.\" | .\" | ||||||||
.\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 | .\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93 | ||||||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||||||
.\" | .\" | ||||||||
.Dd June 30, 2022 | .Dd December 24, 2022 | ||||||||
.Dt SYSCTL 8 | .Dt SYSCTL 8 | ||||||||
.Os | .Os | ||||||||
.Sh NAME | .Sh NAME | ||||||||
.Nm sysctl | .Nm sysctl | ||||||||
.Nd get or set kernel state | .Nd get or set kernel state | ||||||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||||||
.Nm | .Nm | ||||||||
.Op Fl bdehiNnoTtqWx | .Op Fl bdeFhilNnoTtqWx | ||||||||
.Op Fl B Ar bufsize | .Op Fl B Ar bufsize | ||||||||
.Op Fl f Ar filename | .Op Fl f Ar filename | ||||||||
.Ar name Ns Op = Ns Ar value Ns Op , Ns Ar value | .Ar name Ns Op = Ns Ar value Ns Op , Ns Ar value | ||||||||
.Ar ... | .Ar ... | ||||||||
.Nm | .Nm | ||||||||
.Op Fl bdehNnoTtqWx | .Op Fl bdeFhlNnoTtqWx | ||||||||
.Op Fl B Ar bufsize | .Op Fl B Ar bufsize | ||||||||
.Fl a | .Fl a | ||||||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||||||
The | The | ||||||||
.Nm | .Nm | ||||||||
utility retrieves kernel state and allows processes with appropriate | utility retrieves kernel state and allows processes with appropriate | ||||||||
privilege to set kernel state. | privilege to set kernel state. | ||||||||
The state to be retrieved or set is described using a | The state to be retrieved or set is described using a | ||||||||
▲ Show 20 Lines • Show All 41 Lines • ▼ Show 20 Lines | |||||||||
or | or | ||||||||
.Fl n | .Fl n | ||||||||
is specified, or a variable is being set. | is specified, or a variable is being set. | ||||||||
.It Fl f Ar filename | .It Fl f Ar filename | ||||||||
Specify a file which contains a pair of name and value in each line. | Specify a file which contains a pair of name and value in each line. | ||||||||
.Nm | .Nm | ||||||||
reads and processes the specified file first and then processes the name | reads and processes the specified file first and then processes the name | ||||||||
and value pairs in the command line argument. | and value pairs in the command line argument. | ||||||||
.It Fl F | |||||||||
Print the format of the variable. | |||||||||
This is additional information to describe the type of the variable and | |||||||||
most useful with struct types such as clockinfo, timeval, and loadavg. | |||||||||
pauamma_gundo.com: Also, I'm not sure "structured" is the best word. Maybe "compound"? | |||||||||
Done Inline ActionsI didn't realize your suggested changes in the first round of changes. When I looked at lower pages of sysctl.8, I found 'struct' and used it. ota_j.email.ne.jp: I didn't realize your suggested changes in the first round of changes.
When I looked at lower… | |||||||||
Not Done Inline ActionsNo, "struct" is fine for consistency, I think. pauamma_gundo.com: No, "struct" is fine for consistency, I think. | |||||||||
.It Fl h | .It Fl h | ||||||||
Format output for human, rather than machine, readability. | Format output for human, rather than machine, readability. | ||||||||
.It Fl i | .It Fl i | ||||||||
Ignore unknown OIDs. | Ignore unknown OIDs. | ||||||||
The purpose is to make use of | The purpose is to make use of | ||||||||
.Nm | .Nm | ||||||||
for collecting data from a variety of machines (not all of which | for collecting data from a variety of machines (not all of which | ||||||||
are necessarily running exactly the same software) easier. | are necessarily running exactly the same software) easier. | ||||||||
.It Fl l | |||||||||
Show the length of variables along with their values. | |||||||||
Not Done Inline Actions
markj: | |||||||||
Not Done Inline ActionsI think "size" (in bytes?) is more accurate than "length". markj: I think "size" (in bytes?) is more accurate than "length". | |||||||||
This option cannot be combined with the | |||||||||
Not Done Inline Actions
markj: | |||||||||
.Fl N | |||||||||
option. | |||||||||
.It Fl N | .It Fl N | ||||||||
Show only variable names, not their values. | Show only variable names, not their values. | ||||||||
This is particularly useful with shells that offer programmable | This is particularly useful with shells that offer programmable | ||||||||
completion. | completion. | ||||||||
To enable completion of variable names in | To enable completion of variable names in | ||||||||
.Xr zsh 1 Pq Pa ports/shells/zsh , | .Xr zsh 1 Pq Pa ports/shells/zsh , | ||||||||
use the following code: | use the following code: | ||||||||
.Bd -literal -offset indent | .Bd -literal -offset indent | ||||||||
▲ Show 20 Lines • Show All 215 Lines • Show Last 20 Lines |
Also, I'm not sure "structured" is the best word. Maybe "compound"?