日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
SYSRC(8) FreeBSD システム管理者マニュアル SYSRC(8)
名称
sysrc -- 安全にシステム rc ファイルを編集する
書式
sysrc [-cdDeEFhinNqvx] [-s name] [-f file] [-j jail | -R dir]
name[[+|-]=value] ...
sysrc [-cdDeEFhinNqvx] [-s name] [-f file] [-j jail | -R dir] -a | -A
sysrc [-E] [-s name] [-f file] -l
sysrc [-eEqv] -L [name ...]
解説
sysrc ユーティリティは、システム rc ファイルの一群から rc.conf(5) 変数を
検索し、安全で効果的な方法で値を変更する適切な特権があるプロセスを許可し
ます。
次のオプションが利用可能です:
-a すべてのデフォルトでない設定変数のリストをダンプします。
-A すべての設定変数 (incl. defaults) のリストをダンプします。
-c チェックのみ。問い合わせについて、すべての要求された変数が、(た
とえ NULL であっても) 設定されなら、成功を返し、そうでなければ、
エラー状態を返します。割り当てについて、変更が必要とされないな
ら、成功を返し、そうでなければ、失敗を返します。冗長であるなら
(``-v 参照'')、変数が設定されるかどうか、および変更が要求された
かどうかのメッセージの状態を印刷 (表示) します。
-d 与えられた変数の記述を印刷 (表示) します。
-D (複数の) デフォルト値だけ (これは、RC_CONFS を NULL に設定する
か、または NULL ファイル引数がある `-f' を渡すことと同様です) 表
示します。
-e sh(1) 互換の構文 (例えば、`var=value') として問い合わせ結果を印
刷 (表示) します。`-n' または `-F' のいずれかが指定されるなら、
無視されます。
-E 設定ファイルをリストするために `-l' または `-L' を与えるとき、存
在するそれらをリストするだけです。設定を変更するとき、既存のファ
イルを修正することを好みます。
-f file RC_DEFAULTS ファイルの `rc_conf_files' エントリを読み込むことに
よって、取得されたファイルの代わりに指定されたファイルで動作しま
す。追加ファイルのために複数回、このオプションを指定することがで
きます。
-F 各指令が含まれる、最後の rc.conf(5) ファイルだけを表示します。
-h stderr に短い使用法のメッセージを印刷して、終了します。
--help stderr と完全な使用法の文を印刷して、終了します。
-i 未知の変数を無視します。
-j jail (`-R dir' を上書きする。jexec(8) を要求する) で動作するための
jid または jail の名前。
-l 標準出力でスタートアップで使用される設定ファイルをリストして、終
了します。
-L 標準出力で rc.conf.d エントリを含むすべての設定ファイルをリスト
して、終了します。サービス名を表示するために、`-v' または `-e'
を組み合わせすることができます。sysrc は、すべての指定されたサー
ビスがインストールされるなら、成功して終了し、そうでなければ、失
敗します。
-n それらの名前ではなく変数の値のみ表示します。
-N それらの値ではなく変数の名前のみ表示します。
-q 静か。冗長と隠す特定のエラーを無効にします。`-L' と 1 つ以上の
name を組み合わせるとき、出力なしで、終了状態とのみ提供します。
-R dir `/' ではなくルートディレクトリ `dir' 内で動作します。
-s name name の rc.d スクリプトが (``/etc/rc.d'' または local_startup
ディレクトリに) 存在するなら、潜在的に `rc_conf_files' を上書き
するその ``rc.conf.d'' エントリを処理します。``rc.conf.d'' に関
する追加の情報については、rc.subr(8) を参照してください。スター
トアップでサービスによって使用される設定ファイルをリストするため
に、`-l' と組み合わせることができます。
-v 冗長です。指令が見つかったところで、特定の rc.conf(5) ファイルの
パス名を印刷します。
--version
stdout (標準出力) にバージョン情報を印刷 (表示) して、終了しま
す。
-x 指定された (複数の) ファイルから (複数の) 変数を削除します。
このユーティリティは、sysctl(8) に似た構文があります。それは、(上に記述さ
れた) `-e' and `-n' オプションを共有し、問い合わせ/割り付けを行うための
`name[=value]' 構文があります。さらに、(しかし sysctl(8) と違って)、
`name+=value' は、項目を値に追加するためにサポートされ (「付け加える値」
参照)、`name-=value' は、項目を値から削除するためにサポートされます (「取
り去る値」参照)。
しかしながら、sysctl(8) は、エントラント (entrant) カーネルの MIB を問い
合わせ/修正するための役目をしていますが、代わりに sysrc は、システム
rc.conf(5) 設定ファイルの値で動作します。
システム設定ファイルのリストは、デフォルトで、パス名の空白で区切られたリ
ストを含んでいる、変数 `rc_conf_files' 内のファイル
`/etc/defaults/rc.conf' で設定されます。すべての FreeBSD システムにおい
て、これは、デフォルトで値 "/etc/rc.conf /etc/rc.conf.local" になります。
各パス名は、起動時に順番にソースされ (読み込まれ) ます。それは、与えられ
た変数の値を返す前に、sysrc が、設定ファイルをソースする (読み込む) こと
と同じ方法です。
変数名を供給されるとき、sysrc は、変数の値を返します。変数が設定された
`rc_conf_files' のいずれにも現われないなら、エラーが、印刷 (表示) され、
エラー状態が、返されます。
与えられた変数の値を変更するとき、変数が `rc_conf_files' のいずれかに現わ
れるかどうかは、重要ではありません。変数がファイルのいずれかに現われない
なら、それは、`rc_conf_files' 変数の最初のパス名の終りに追加されます。そ
うでなければ、sysrc は、変数を含む見つかった最後のファイルの最後の存在だ
けを置換します。これは、これらのなくてはならないファイルを大量に修正せず
に、次のブートで効力が生じる値を取得します (繰り返し呼び出される sysrc さ
れる、ファイルが扱いにくく成長することができることに注意しません)。
付け加える値
既存の値に項目を追加するために `key+=value' 構文を使用するとき、値の最初
の文字は、項目 (通常 " " または ",") を区切るためにデリミタとして取られま
す。例えば、次の文で:
sysrc cloned_interfaces+=" gif0"
最初の文字は、空白であり、既存の値が、空白類によって区切られると見なされ
ることを sysrc に知らせます。`gif0' が、cloned_interfaces のための既存の
値で見つけられるなら、それは、(既存の値が NULL でない場合のみ、デリミタ
で) 追加されます。
便宜上、最初の文字が英数字 (文字 A-Z, a-z または数字 0-9、ドット) (). ま
たはスラッシュ (/) であるなら、sysrc は、セパレータとして空白類のデフォル
トの設定を使用します。例えば、上記と下記の文は、``gif0'' が英数字文字 (文
字 g) で始まるので同等です:
sysrc cloned_interfaces+=gif0
例えば、次のシーケンスを取ります:
sysrc cloned_interfaces= # NULL で始まる
sysrc cloned_interfaces+=gif0
# NULL -> `gif0' (注: 先行するデリミタなし)
sysrc cloned_interfaces+=gif0 # 変更なし
sysrc cloned_interfaces+="tun0 gif0"
# `gif0' -> `gif0 tun0' (注: 重複なし)
sysrc は、既にあるなら、同じ値が追加されることを防ぎます。
取り去る値
既存の値から項目を削除するために `key-=value' 構文を使用する、値の最初の
文字は、項目 (通常 " " または ",") を区切るためにデリミタとして取られま
す。例えば、次の文で:
cloned_interfaces-=" gif0"
最初の文字は、空白であり、既存の値が、空白類によって区切られると見なされ
ることを sysrc に知らせます。`gif0' が、cloned_interfaces のための既存の
値で見つけられるなら、それは、(削除される特別のデリミタ) を削除されます。
便宜上、最初の文字が英数字 (文字 A-Z, a-z または数字 0-9、ドット) (). ま
たはスラッシュ (/) であるなら、sysrc は、セパレータとして空白類のデフォル
トの設定を使用します。例えば、上記と下記の文は、``gif0'' が英数字文字 (文
字 g) で始まるので同等です:
sysrc cloned_interfaces-=gif0
例えば、次のシーケンスを取ります:
sysrc foo="bar baz" # start
sysrc foo-=bar # `bar baz' -> `baz'
sysrc foo-=baz # `baz' -> NULL
sysrc は、提供されたすべての項目のすべての発生と項目の間の壊れた特別のデ
リミタを削除します。
環境変数
次の環境変数は、sysrc によって参照されます:
RC_CONFS (たとえ、NULL に設定されても) デフォルトの `rc_conf_files'
を上書きします。
RC_DEFAULTS `/etc/defaults/rc.conf' ファイルの位置。
依存関係
次の標準コマンドが、sysrc によって要求されます:
awk(1), cat(1), chmod(1), env(1), grep(1), mktemp(1), mv(1), rm(1),
sh(1), stat(1), tail(1), chown(8), jls(8) と jexec(8)。
関連ファイル
/etc/defaults/rc.conf
/etc/rc.conf
/etc/rc.conf.local
/etc/rc.conf.d/name
/etc/rc.conf.d/name/*
/usr/local/etc/rc.conf.d/name
/usr/local/etc/rc.conf.d/name/*
使用例
下記は、システム設定ファイルの rc.conf(5) の一群から特定の値を問い合わせ
るために、どのように sysrc を使用することができるかのいくつかの単純な例で
す:
sysrc sshd_enable
$sshd_enable の値を返します、通常、YES または NO。
sysrc defaultrouter (デフォルトルータ)
(設定されているなら) デフォルトルータの IP アドレスを返します。
crontab(5) のような他のファイルで動作します:
sysrc -f /etc/crontab MAILTO
(設定されているなら) MAILTO 設定の値を返します。
既存の値に付け加えます:
sysrc cloned_interfaces+=gif0
"gif0" を $cloned_interfaces に付け加えます (「付け加える値」参
照)。
sysrc cloned_interfaces-=gif0
"gif0" を $cloned_interfaces から削除します (「取り去る値」参照)。
上記の構文に加えて、また sysrc は、下記に示される、報告される方法の値を変
更のためにインラインの sh(1) PARAMETER 拡張をサポートします:
sysrc 'hostname%%.*'
最初の `.' (しかし、含まず) まで $hostname を返します。
sysrc 'network_interfaces%%[$IFS]*'
$network_interfaces の最初の単語を返します。
sysrc 'ntpdate_flags##*[$IFS]'
$ntpdate_flags の最後の単語を返します (時間サーバアドレス)。
sysrc usbd_flags-"default"
$usbd_flags または設定されていないか、NULL であるなら、デフォルトを
返します。
sysrc cloned_interfaces+"alternate"
$cloned_interfaces が設定されているなら、"alternate" を返します。
関連項目
rc.conf(5), rc.subr(8), jail(8), jexec(8), jls(8), rc(8), sysctl(8)
歴史
sysrc ユーティリティは、FreeBSD 9.2 ではじめて登場しました。
作者
Devin Teske <dteske@FreeBSD.org>
感謝
提案、支援とテストについて、Brandon Gooch, Enji Cooper, Julian Elischer,
Pawel Jakub Dawidek, Cyrille Lefevre, Ross West, Stefan Esser, Marco
Steinbach, Jilles Tjoelker, Allan Jude と Lars Engels。
FreeBSD 12.2 February 2, 2016 FreeBSD 12.2