名称

書式

解説

3 ウェイマージを実行するために、 etcupdate は、それが管理するファイルの現在と以前のバージョンのコピーを保持しています。これらのコピーは、“current” (現在) と“previous” (以前) ツリーとして知られている 2 つのツリーに格納されます。マージの間に、 etcupdate は、各ファイルのローカルのバージョンにマージされる必要がある変更を決定するための各ファイルの“current”と“previous”コピーを比較します。衝突を起こさずにファイルを更新することができるなら、 etcupdate は、ファイルを自動的に更新します。ファイルへのローカルな変更がソースツリーのファイルに行われた変更と衝突するなら、マージの衝突が生成されます。衝突は、マージが終了した後に、解決されなければなりません。 etcupdate ユーティリティは、以前のマージからすべての衝突が解決されるまで、新しいマージを実行しません。

モード

オプション

-B

プライベートのオブジェクトツリーで生成されたファイルを構築しません。代わりに、ソースツリーとマッチする以前に構築されたオブジェクトツリーから生成されたファイルを再使用します。これは、ブートストラップするとき、 sendmail(8) の設定ファイルで理由のない衝突を回避するために役に立ちます。また、特定の world build とマッチする tarball を構築するために役に立ちます。

-d workdir

作業ディレクトリとして使用する代替のディレクトリを指定します。仕事ディレクトリは、未解決の衝突と同様に“current”と“previous”ツリーに格納するために使用されます。デフォルトの作業ディレクトリは、 <destdir>/var/db/etcupdate です。

-A patterns

常に、 patterns にリストされたパターンのうちのいずれもマッチする、あらゆるファイルの新しいバージョンをインストールします。各パターンは、 sh(1) シェルパターンとして評価されます。複数のパターンを指定するために、このオプションを複数回指定することができます。また、複数の空白で区切られたパターンは、単一のオプションで指定できます。 IGNORE_FILES 変数または -I オプションを通して指定された無視されるファイルは、インストールされないことに注意してください。

-D destdir

マージのターゲットとして代替の目的ディレクトリを指定します。これは、‘make installworld’で使用される DESTDIR 変数に類似しています。デフォルトの目的ディレクトリは、ローカルマシンで更新する /etc をマージする結果である空の文字列です。

-F

目的ディレクトリのファイルと“current”または“previous”ツリーのいずれかのファイルと比較するとき、FreeBSD ID 文字列の変更を無視します。 diff モードにおいて、これは、出力の FreeBSD ID 文字列の変更のためのノイズ (雑音) を減らします。更新の間に、これは、FreeBSD ID 文字列の変更によって引き起こされる安全な衝突のための取り扱いを単純化することができます。

特に、目的ディレクトリのファイルが“previous”ツリーのモジュロの FreeBSD ID 文字列の同じファイルと同一であるなら、ファイルは、あたかもそれが未変更で、ファイルの“current”バージョンがインストールされるかのように、扱われます。同様に、目的ディレクトリのファイルが“current”ツリーのモジュロの FreeBSD ID 文字列の同じファイルと同一であるなら、ファイルの“current”バージョンは、ID 文字列を更新するためにインストールされます。ファイルの“previous”と“current”バージョンが同一であるなら、 etcupdate は、目的ディレクトリのファイルを変更しません。

diff(1) コマンドの制限のために、このオプションは、FreeBSD ID 文字列をクローズするファイルの他の変更があるなら、効果がありません。

-I patterns

patterns にリストされたパターンのいずれかにマッチするあらゆるファイルを無視します。警告または他のメッセージは、マージの間にそれらのファイルのために生成されません。各パターンは、 sh(1) シェルパターンとして評価されます。複数のパターンを指定するために、このオプションを複数回指定することができます。また、複数の空白で区切られたパターンは、単一のオプションで指定できます。

-L logfile

ログファイルのための代替のパスを指定します。 etcupdate ユーティリティは、標準出力と標準エラーとともに、それが起動する各コマンドをこのファイルにログ記録します。デフォルトで、ログファイルは、作業ディレクトリの log と名前が付けられたファイルに格納されます。

-M options

“current”ツリーを構築するとき、 make(1) への追加パラメータとして、 options を渡します。クロス構造のために TARGET または TARGET_ARCH 変数を設定するために、これを使用することができます。

-n

“dry-run”モードを有効にします。目的ディレクトリへのあらゆる変更をマージしません。代わりに、アクションがマージの間に取られるものを報告します。既存の“current”と“previous”ツリーが変更されないことに注意してください。 -r オプションが指定されないなら、一時的な“current”ツリーは、比較を実行するために抽出されます。

-r

マージの間に“current”と“previous”ツリーを更新しません。前のマージ操作を“再実行”するために、これを使用することができます。

-s source

“current”ツリーを構築するか抽出するとき、使用する代替のソースツリーを指定します。デフォルトのソースツリーは、 /usr/src です。

-t tarball

ソースツリーからツリーを構築するのではなく、 build コマンドによって以前に生成された tarball から新しい“current”ツリーを抽出します。

設定ファイル

ALWAYS_INSTALL

-A オプションに似ている、この変数でリストされたパターンのいずれかにマッチするファイルを常にインストールします。

DESTDIR

-D オプションに似ている代替の目的ディレクトリを指定します。

EDITOR

マージの衝突を編集するプログラムを指定します。

FREEBSD_ID

-F オプションに似ている FreeBSD ID 文字列の変更を無視します。これは、変数を空でない値に設定することによって有効になります。

IGNORE_FILES

-I オプションに似ている、この変数でリストされたパターンのいずれかにマッチするファイルを無視します。

LOGFILE

-L オプションに似ているログファイルのための代替のパスを指定します。

MAKE_OPTIONS

-M オプションに似ている“current”ツリーを構築するとき、 make(1) への追加オプションを渡します。

SRCDIR

-s オプションに似ている代替のソースツリーを指定します。

WORKDIR

-d オプションに似ている代替の作業ディレクトリを指定します。

環境変数

関連ファイル

/etc/etcupdate.conf

オプションの設定ファイル。

/var/db/etcupdate

デフォルトの作業ディレクトリは、ツリーと他のデータを格納するために使用されます。

/var/db/etcupdate/log

デフォルトのログファイル。

終了ステータス

使用例

etcupdate extract

buildworld と installworld プロセスを通してアップグレードした後に、変更をマージするためには:

etcupdate

マージの間に生成されたあらゆる衝突を解決するためには:

etcupdate resolve

診断

Directory mismatch: <path> (<type>)

path でディレクトリを作成する試みが行われましたが、タイプ“type”の既存のファイルは、既にそのパス名に存在します。

Modified link changed: <file> (<old> became <new>)

file と名前が付けられたシンボリックリンクのターゲットは、“current”ツリーで“old”から“new”に変更されました。シンボリックリンクは、目的ディレクトリの“old”でも“new”でもないターゲットを指すために修正されました。

Modified mismatch: <file> (<new> vs <dest>)

タイプ“new”の file と名前が付けられたファイルは、“current”ツリーで修正されましたが、ファイルは、目的ディレクトリに異なるタイプ“dest”として存在します。

Modified <type> changed: <file> (<old> became <new>)

file と名前がつけられたファイルは、“previous”ツリーの“old”から“current”ツリーのタイプ“new”にタイプを変更しました。タイプ“type”の目的ディレクトリのファイルは、修正されているので、自動的にマージすることができないかもしれません。

Modified <type> remains: <file>

file と名前が付けられたタイプ“type”のファイルは、“current”ツリーから削除されますが、それは、局所的に修正されました。ファイルの修正されたバージョンは、目的ディレクトリに残ります。

Needs update: /etc/mail/aliases.db (required manual update via newaliases(1))

ファイル /etc/mail/aliases は、空でない目的ディレクトリでマージの間に更新されました。 newaliases(1) コマンドの制限のために、 etcupdate は、対応する別名 (aliases) データベースを自動的に更新することができませんでした。

New file mismatch: <file> (<new> vs <dest>)

タイプ“new”の file と名前が付けられた新しいファイルは、“current”ツリーに追加されました。その名前のファイルは、目的ディレクトリに既に存在しますが、それは、異なるタイプ“dest”です。

New link conflict: <file> (<new> vs <dest>)

file と名前が付けられたシンボリックリンクは、“new”にリンクする“current”ツリーに追加されました。同じ名前のシンボリックリンクは、既に目的ディレクトリに存在しますが、それは、異なるターゲット“dest”とリンクします。

Non-empty directory remains: <file>

ディレクトリ file は、“current”ツリーから削除されましたが、それは、目的ディレクトリの追加ファイルを含んでいます。ディレクトリと同様にこれらの追加ファイルは、残ります。

Remove mismatch: <file> (<old> became <new>)

file と名前がつけられたファイルは、“previous”ツリーのタイプ“old”から“current”ツリーのタイプ“new”に変更されますが、それは、目的ディレクトリで削除されていました。

Removed file changed: <file>

file と名前がつけられたファイルは、“current”ツリーで修正されましたが、それは、目的ディレクトリで削除されていました。

Removed link changed: <file> (<old> became <new>)

file と名前がつけられたシンボリックリンクのターゲットは、“current”ツリーで“old”から“new”に変更されましたが、それは、目的ディレクトリで削除されていました。

関連項目

歴史

作者

バグ

特定のファイルのための簡単に自動化された衝突を解決する方法はありません。例えば、自動化された方法で特定の衝突を解決するために次の行

etcupdate resolve tf /some/file

に沿った構文を想像することができます。

ファイルの stock バージョンがあるファイルの局所的な修正バージョンを置き換えるために‘revert’コマンドに何か似ていて便利であるかもしれません。例えば:

etcupdate revert /etc/mail/freebsd.cf

etcupdate をブートストラップすることは、しばしば最初のマージで衝突を生じる /etc/mail/*.cf の根拠のない diff の結果となります。ブートストラップするとき、ソースツリーとマッチするオブジェクトツリーが存在するなら、 extract コマンドへ -B フラグを渡すことで、これを対処することができます。