eddc7bb959
apm.8, apmd.8, and wlconfig.8 will be deleted after repocopy is finished. Submitted by: koizumistr at minos ocn ne jp Coordinated by: Nobuyuki Koganemaru <n-kogane at syd odn ne jp>
308 lines
8.7 KiB
Groff
308 lines
8.7 KiB
Groff
.\" Copyright (c) 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 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.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``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. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" 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
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" From: @(#)sysctl.8 8.1 (Berkeley) 6/6/93
|
|
.\" %FreeBSD: src/sbin/sysctl/sysctl.8,v 1.54.2.2 2005/02/12 15:18:11 brueffer Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd March 10, 2002
|
|
.Dt SYSCTL 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm sysctl
|
|
.Nd カーネル状態の取得や設定
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl bdehNnox
|
|
.Ar name Ns Op = Ns Ar value
|
|
.Ar ...
|
|
.Nm
|
|
.Op Fl bdehNnox
|
|
.Fl a
|
|
.Sh 解説
|
|
.Nm
|
|
はカーネル状態を取り出し、適切な権限があれば
|
|
プロセスがカーネル状態を設定することを許します。
|
|
取り出されたり、設定されたりした状態は、
|
|
.Dq Management Information Base
|
|
.Pq Dq MIB
|
|
形式を使って記述されます。
|
|
この形式では、要素はドット ``.'' で接続されます。
|
|
.Pp
|
|
以下のオプションを使用可能です:
|
|
.Bl -tag -width indent
|
|
.It Fl A
|
|
.Fl o a
|
|
と等価です (互換性用)。
|
|
.It Fl a
|
|
現在利用可能な、データ形式を知らないもの (以下、形式不明の変数と称する)
|
|
でない値を列挙します。
|
|
1 個以上の変数名がコマンドラインに指定された場合、
|
|
本オプションは無視されます。
|
|
.It Fl b
|
|
変数の値を加工せずに、バイナリ形式で表示します。
|
|
変数名や、最後の改行文字は出力されません。
|
|
これは、単一の変数に対して操作する際に便利でしょう。
|
|
.It Fl d
|
|
変数の値の代りに解説を表示します。
|
|
.It Fl e
|
|
変数の名前と値を、
|
|
.Ql =
|
|
で区切ります。
|
|
.Nm
|
|
ユーティリティにフィードバック可能な出力を生成するために有用です。
|
|
.Fl N
|
|
または
|
|
.Fl n
|
|
が指定される場合、または変数が設定される場合、本オプションは無視されます。
|
|
.It Fl h
|
|
マシンが読み易いフォーマットではなく、人間が読み易いフォーマットで出力します。
|
|
.It Fl N
|
|
値の出力は抑制されて、変数名のみを表示します。
|
|
プログラム可能な補完機能を持つシェルで、有用です。
|
|
.Xr zsh 1
|
|
で変数名を補完するには、次のコードを使用します:
|
|
.Bd -literal -offset indent
|
|
listsysctls () { set -A reply $(sysctl -AN ${1%.*}) }
|
|
compctl -K listsysctls sysctl
|
|
.Ed
|
|
.Pp
|
|
.Xr tcsh 1
|
|
で変数名を補完するには、次のようにします:
|
|
.Pp
|
|
.Dl "complete sysctl 'n/*/`sysctl -Na`/'"
|
|
.It Fl n
|
|
変数名の出力は抑制されて、値だけが表示されます。
|
|
これはシェル変数を設定するのに役に立ちます。
|
|
たとえば、ページサイズを変数
|
|
.Va psize
|
|
に保存するには、以下のようにします:
|
|
.Pp
|
|
.Dl "set psize=`sysctl -n hw.pagesize`"
|
|
.It Fl o
|
|
形式不明な値を表示します (通常は抑制されます)。
|
|
書式と長さが表示され、値の最初の 16 バイトが 16 進数でダンプされます。
|
|
.It Fl X
|
|
.Fl x a
|
|
と等価です (互換性用)。
|
|
.It Fl x
|
|
.Fl o
|
|
と同様ですが、
|
|
形式不明の変数の最初の数バイトの代りに全ての内容が 16 進数でダンプされます。
|
|
.El
|
|
.Pp
|
|
.Nm
|
|
で得られる情報は、整数、文字列、デバイス
|
|
.Pq Vt dev_t
|
|
、形式不明の変数です。
|
|
.Nm
|
|
ユーティリティはいくつかの形式不明の変数の形式を知っているだけで、
|
|
それ以外のものに
|
|
対しては 16 進ダンプに頼ります。
|
|
形式不明の変数の情報は、
|
|
.Xr ps 1 ,
|
|
.Xr systat 1 ,
|
|
.Xr netstat 1
|
|
などの特別な目的のプログラムによって取得された場合に、より効果的です。
|
|
.Pp
|
|
通常のシステム動作中には修正できない変数のいくつかは、
|
|
.Xr loader 8
|
|
チューナブルで修正可能です。
|
|
例えば、これらを
|
|
.Xr loader.conf 5
|
|
で設定することで実現できます。
|
|
どのようなチューナブルが利用可能か、そしてそれらをどのように設定するのか
|
|
という更なる情報については、
|
|
.Xr loader.conf 5
|
|
を参照してください。
|
|
.Pp
|
|
文字列と整数の情報を簡単にまとめて以下に示します。
|
|
これらの変数の詳細な説明は、
|
|
.Xr sysctl 3
|
|
を参照してください。
|
|
.Pp
|
|
変更可能の列は、適切な権限を持つプロセスがその値を変更
|
|
できるかどうかを示しています。
|
|
文字列、整数、デバイス値を
|
|
.Nm
|
|
で設定可能です。
|
|
デバイス値
|
|
.Ar value
|
|
は、キャラクタデバイススペシャルファイル名で指定可能です。
|
|
特殊な値
|
|
.Cm off
|
|
と
|
|
.Cm none
|
|
は
|
|
.Dq デバイス無し
|
|
を意味します。
|
|
.Bl -column security.bsd.unprivileged_read_msgbuf integerxxx
|
|
.It Sy "名称 型 変更可能
|
|
.It "kern.ostype 文字列 no
|
|
.It "kern.osrelease 文字列 no
|
|
.It "kern.osrevision 整数 no
|
|
.It "kern.version 文字列 no
|
|
.It "kern.maxvnodes 整数 yes
|
|
.It "kern.maxproc 整数 no
|
|
.It "kern.maxprocperuid 整数 yes
|
|
.It "kern.maxfiles 整数 yes
|
|
.It "kern.maxfilesperproc 整数 yes
|
|
.It "kern.argmax 整数 no
|
|
.It "kern.securelevel 整数 増やすのみ
|
|
.It "kern.hostname 文字列 yes
|
|
.It "kern.hostid 整数 yes
|
|
.It "kern.clockrate struct no
|
|
.It "kern.posix1version 整数 no
|
|
.It "kern.ngroups 整数 no
|
|
.It "kern.job_control 整数 no
|
|
.It "kern.saved_ids 整数 no
|
|
.It "kern.boottime struct no
|
|
.It "kern.domainname 文字列 yes
|
|
.It "kern.filedelay 整数 yes
|
|
.It "kern.dirdelay 整数 yes
|
|
.It "kern.metadelay 整数 yes
|
|
.It "kern.osreldate 文字列 no
|
|
.It "kern.bootfile 文字列 yes
|
|
.It "kern.corefile 文字列 yes
|
|
.It "kern.dumpdev dev_t yes
|
|
.It "kern.logsigexit 整数 yes
|
|
.It "security.bsd.suser_enabled 整数 yes
|
|
.It "security.bsd.see_other_uids 整数 yes
|
|
.It "security.bsd.unprivileged_proc_debug 整数 yes
|
|
.It "security.bsd.unprivileged_read_msgbuf 整数 yes
|
|
.It "vm.loadavg struct no
|
|
.It "hw.machine 文字列 no
|
|
.It "hw.model 文字列 no
|
|
.It "hw.ncpu 整数 no
|
|
.It "hw.byteorder 整数 no
|
|
.It "hw.physmem 整数 no
|
|
.It "hw.usermem 整数 no
|
|
.It "hw.pagesize 整数 no
|
|
.It "hw.floatingpoint 整数 no
|
|
.It "hw.machine_arch 文字列 no
|
|
.It "machdep.console_device dev_t no
|
|
.It "machdep.adjkerntz 整数 yes
|
|
.It "machdep.disable_rtc_set 整数 yes
|
|
.It "machdep.guessed_bootdev 文字列 no
|
|
.It "user.cs_path 文字列 no
|
|
.It "user.bc_base_max 整数 no
|
|
.It "user.bc_dim_max 整数 no
|
|
.It "user.bc_scale_max 整数 no
|
|
.It "user.bc_string_max 整数 no
|
|
.It "user.coll_weights_max 整数 no
|
|
.It "user.expr_nest_max 整数 no
|
|
.It "user.line_max 整数 no
|
|
.It "user.re_dup_max 整数 no
|
|
.It "user.posix2_version 整数 no
|
|
.It "user.posix2_c_bind 整数 no
|
|
.It "user.posix2_c_dev 整数 no
|
|
.It "user.posix2_char_term 整数 no
|
|
.It "user.posix2_fort_dev 整数 no
|
|
.It "user.posix2_fort_run 整数 no
|
|
.It "user.posix2_localedef 整数 no
|
|
.It "user.posix2_sw_dev 整数 no
|
|
.It "user.posix2_upe 整数 no
|
|
.It "user.stream_max 整数 no
|
|
.It "user.tzname_max 整数 no
|
|
.El
|
|
.Sh 使用例
|
|
たとえば、システム中で許されている最大のプロセス数を知りたい
|
|
ときは、以下のようにします:
|
|
.Pp
|
|
.Dl "sysctl kern.maxproc"
|
|
.Pp
|
|
システム中で許されている最大のプロセス数を 1000 に設定する
|
|
には、以下のようにします:
|
|
.Pp
|
|
.Dl "sysctl kern.maxprocperuid=1000"
|
|
.Pp
|
|
クラッシュダンプに使用するデバイスは次のように指定可能です:
|
|
.Pp
|
|
.Dl "sysctl kern.dumpdev=/dev/somedev"
|
|
.Pp
|
|
これは次と等価です
|
|
.Pp
|
|
.Dl "dumpon /dev/somedev"
|
|
.Pp
|
|
システムのクロックレートに関する情報を得るには、以下の
|
|
ようにします:
|
|
.Pp
|
|
.Dl "sysctl kern.clockrate"
|
|
.Pp
|
|
システム負荷 (ロード・アベレージ) の履歴に関する情報を
|
|
得るには、以下のようにします:
|
|
.Pp
|
|
.Dl "sysctl vm.loadavg"
|
|
.Pp
|
|
ここに挙げたもの以外の変数も存在します。
|
|
それらに関するより深い意味を知る
|
|
もっとも良く、かつ、おそらく唯一の方法は、それらを定義しているソースコードを
|
|
みる事であることは疑いのない事実でしょう。
|
|
.Sh 関連ファイル
|
|
.Bl -tag -width ".In netinet/icmp_var.h" -compact
|
|
.It In sys/sysctl.h
|
|
トップレベルの識別子、第 2 レベルのカーネル/ハードウェア識別子、
|
|
そしてユーザレベル識別子の定義
|
|
.It In sys/socket.h
|
|
第 2 レベルのネットワーク識別子の定義
|
|
.It In sys/gmon.h
|
|
第 3 レベルのプロファイル識別子の定義
|
|
.It In vm/vm_param.h
|
|
第 2 レベルの仮想メモリ識別子の定義
|
|
.It In netinet/in.h
|
|
第 3 レベルのインターネット識別子と
|
|
第 4 レベルの IP 識別子の定義
|
|
.It In netinet/icmp_var.h
|
|
第 4 レベルの ICMP 識別子の定義
|
|
.It In netinet/udp_var.h
|
|
第 4 レベルの UDP 識別子の定義
|
|
.El
|
|
.Sh 互換性
|
|
.Fl w
|
|
オプションは推奨されておらず、黙って無視されます。
|
|
.Sh 関連項目
|
|
.Xr sysctl 3 ,
|
|
.Xr loader.conf 5 ,
|
|
.Xr sysctl.conf 5 ,
|
|
.Xr loader 8
|
|
.Sh バグ
|
|
現状では
|
|
.Nm
|
|
ユーティリティは、sysctl ツリーの追跡、および、形式と名前の情報を得る際に、
|
|
文書化されていないカーネルの sysctl 機能へのインタフェースを使用しています。
|
|
この方法に関する正しいインタフェースは、現在検討中です。
|
|
.Sh 歴史
|
|
.Nm
|
|
ユーティリティは
|
|
.Bx 4.4
|
|
ではじめて登場しました。
|
|
.Pp
|
|
.Fx 2.2
|
|
の
|
|
.Nm
|
|
は著しく改良されています。
|