aeimport - クラウド上のオンライン

プログラム：

NAME

aeimport - 外部リポジトリを Aegis にインポートします

SYNOPSIS

インポート [ オプション...] ディレクトリ名
インポート -ヘルプ
インポート -バージョン

DESCRIPTION

この インポート コマンドを使用して新しいプロジェクトを作成し、
プロジェクト履歴を失うことなく、外部リポジトリ (RCS や CVS など) にアクセスできます。

注: バージョンを指定しない限り ( -バージョン 以下のオプション) このコマンド
デフォルトでは、バージョン 1.0 をサポートするブランチを作成します。 これも発見したら
遅れてもすべてが失われるわけではありません。 えんぶる(1) 枝を取り除くコマンド
望まなかった。

ディレクトリ
プロジェクト ディレクトリ。その下にプロジェクトのベースライン、履歴、状態、変更が含まれます。
データは保持されており、この時点で作成されます。 もし -ディレクトリ オプションが指定されていない場合、
プロジェクト ディレクトリは、default_project_‐ で指定されたディレクトリに作成されます。
のディレクトリフィールド aeuconf(5)、または現在のユーザーのホーム ディレクトリに設定されていない場合。 どちらかで
プロジェクトと同じ名前のケース。

スタッフ
プロジェクトは、現在のユーザーとグループを所有者ユーザーおよびグループとして作成されます。 の
現在のユーザーはプロジェクトの管理者です。 このプロジェクトには他に何もありません
管理者 (使用 あいな(1) さらに追加します)。

プロジェクトには、次のようにインストールされた履歴ファイル (下記を参照) にあるすべてのユーザー名が含まれます。
開発者、レビュー担当者、インテグレーター。 これはおそらく広すぎるかもしれませんが、かなり正確です
ほとんどのリポジトリにある広範なアクセス許可を再現します。
アード（1） あーる（1）と エアリー(1) 必要に応じてこのリストを選別します。

名前が XNUMX つだけ見つかった場合、プロジェクトは「developers_may_review = true;」に設定されます。
それ以外の場合は false になります (参照 アエパット詳細については (5) を参照してください)。 使用 アエパ(1) 変えること
別の設定が必要な場合はこれを選択します。

プロジェクトの umask は現在のユーザーの umask から派生しますが、保証するために変更されます。
グループのメンバーがアクセス権を持ち、プロジェクト所有者のみが書き込み権を持ちます。
アクセス。 一般的に、このプロジェクトの最良の点は次のとおりです。 他のアカウントによって所有されている
これにより、「おっと、別の場所にいると思った」というエラーが発生するのを防ぐことができます。

プロジェクトの履歴コマンド (「 aepconf(5) 詳細) に設定されます。
RCSに適しています。 ビルド コマンドは「exit 0」に設定されます。 何かに設定する必要があります
適切な。 シンボリック リンク ファームがオンになります。

ポインタ
プロジェクト ポインタは、検索パスの最初の要素に追加されるか、パスがない場合は追加されます。
が設定されています。 これが不適切な場合は、 -図書館 希望する内容を明示的に設定するオプション
位置。 を参照してください。 -図書館 詳細については、オプションを参照してください。

あるいは、AEGIS_PATH 環境変数の設定を解除して、プロジェクトをグローバルに追加します。
プロジェクトリスト。


プロジェクトのバージョンは次の XNUMX つの方法で指定できます。

1. バージョン番号がプロジェクト名に暗黙的に含まれる場合があります。その場合、バージョンは
数字が削られてしまいます。 たとえば、「aeimport -p example.1.2」と実行すると、
「example」という名前のプロジェクト。ブランチ番号 1 が作成され、ブランチ 2 のサブブランチ 1 が作成されます。
作成しました。

2. バージョン番号を明示的に指定することもできます。その場合、バージョン番号はさらに細分化されます。
枝番号。 たとえば、「aeimport -p example -version 1.2」と入力するとプロジェクトが作成されます。
「example」と呼ばれるブランチ番号 1 が作成され、ブランチ 2 のサブブランチ 1 が作成されます。

いずれの場合も、これらのブランチには、プロジェクト名が与えられる場所ならどこにでも名前を付けることができます。
「-p example.1」と「-p example-1.2」。 実際の句読点文字は重要ではありません。

任意の深さのバージョン番号を指定できます。 バージョンを指定する両方の方法
数値を使用することもでき、それらは組み合わせられます。 バージョン番号をまったく必要としない場合は、
つかいます -バージョン 「-version -」のように、引数として XNUMX つのダッシュを使用します。

明示的または暗黙的にバージョン番号が指定されていない場合は、バージョン 1.0 が使用されます。

プロジェクト ディレクトリ 企業名簿
お近くのLuxinar支社またはディストリビューターに ご注意: Aegis はまた、基礎となるファイル システムを参照して、その概念を決定します。
最大ファイルサイズ。 ファイルシステムの最大ファイルサイズが以下の場合
最大ファイル名の長さ、ファイルシステムが勝ちます。 これは、たとえば、次のような場合に発生する可能性があります。
Linux UMSDOS ファイル システムを使用するか、NFS が古い V7 をマウントしている場合
ファイルシステム。 設定 最大ファイル名の長さ この場合、255 に変更しても、
実際、基礎となるファイル システムの制限ははるかに小さい (それぞれ 12 と 14)。

開発ディレクトリ (またはプロジェクト全体) が次のファイル名を持つファイルシステム上にある場合
制限があるか、異種ビルドの一部がそのような環境で行われる場合、
Aegis が何であるかを伝えるのに役立ちます (プロジェクトを使用) 設定 ファイルのフィールド)
プロジェクトがより寛容な環境に基づいて構築される状況に遭遇しないようにする
ただし、より制限された環境では不可解なエラーが発生して失敗します。

開発ディレクトリが日常的に Linux UMSDOS ファイルシステム上にある場合は、次のようにします。
おそらく設定した方が良いでしょう dos_ファイル名_必須 = true、また、
開発ディレクトリのテンプレート 分野。 さまざまなWindowsによるヘテロジニアス開発
環境によってはこれが必要になる場合もあります。

、 プロセス

ほとんどのファイル バージョン システムは、変更セットを使用して動作しません。 このようなものを輸入するには
リポジトリを Aegis にインポートするには、これらの変更セットを「検出」する必要があります。 次の
次の手順が実行されます。

1.
ディレクトリ (ダーパス) コマンドラインで指定されたものと、その下のすべてのディレクトリは次のようになります。
適切なファイルをスキャンします (たとえば、RCS と CVS は「,v」接尾辞を持つファイルを使用します)。
これらのファイルは、ファイルの履歴を取得するために読み取られます。
標準以外のファイル接尾辞を使用している場合、aeimport はファイルを見つけることができません。
ファイル。
CVS リポジトリに複数のモジュールがある場合、aeimport は (まだ)
CVSROOT/modules ファイルを理解します。 aeimport を CVSROOT 全体に指定すると、
予想外に大きな結果が得られます。

2.
前の手順で検出された履歴ファイルは、次の手順で使用される場所にコピーされます。
イージス。 他のツールとは異なり、Aegis にはすべてのツールではなく、プロジェクトごとにリポジトリがあります。
同じリポジトリを共有するプロジェクト。
これは、Aegis が元の履歴ファイルを変更しないことも意味します。 特に、
インポートによって予期しない結果が生成された場合は、プロジェクトを削除するだけです (「 aermpr（1）
詳細を参照)、もう一度やり直してください。
すべての履歴ファイルを $CVSROOT の下に残しておき、Aegis を使用することはできません。
それらを指さしてください。

3.
さまざまなファイル履歴で言及されている各ユーザーのタイムスタンプが検査され、
ほぼ同時にコミットされたファイルのグループを検索します。 ファイルが変更されました
互いに 1 分以内の距離はグループとみなされます。
ファイルは XNUMX 分以内に変更されますが、別のユーザーによって変更されます。 グループとみなされます。
開発者はほとんど単独で作業するため、通常はこれが問題になることはありません。 まれに
開発者が協力して作業する場合、コミットを行うのはそのうちの XNUMX 人だけです。
場合によっては、時間枠が大きすぎて、いくつかの非常に小さな変更が発生する可能性があります。
XNUMX つの大きな変更セットとして見なされます。 実際には、これはあまり一般的ではありません。

4.
ファイルのグループは、完了した変更として Aegis データベースに保存されます (つまり、
アイパス(1) はすでに実行されています)。 変更の説明は、すべての変更を連結したものです。
関連するファイルのバージョンに添付されている固有のコメント。 使用されるタイムスタンプ
変更内容は、グループ内のファイルの最新のタイムスタンプです。
ファイルコメント間の小さなタイプミスにより、長くなる場合があります。
予想を超える変更の説明。 これは次のように修正できます アエカ（1）または トカエカ(1) の場合
希望。 また、その逆の場合もあります。一部のファイルにはコメントがありません。
結果として得られる説明はあまり役に立ちません。

5.
タグは、ファイルからデルタ名を転送することによってデルタ名に変換されます。
接続されている変更セットに接続されています。 タグが次のように表示される場合
複数の変更に添付される場合は、最新の変更にのみ添付されます。
一般的な使用法では、タグは Aegis のデルタ番号と同様の目的を果たします。 彼らです
特定のリリースでは、（通常は）すべてが XNUMX つの CVS コマンドで適用されます。
後で再作成されます。 ただし、各ファイルのバージョンが異なるため、
それぞれの最新バージョンは、さまざまなランダムな変更セットに含まれています。
タグは他の目的にも使用されます。 ここで挙げた方法はあくまで推測ですが、
かなりうまく機能するもの。

aeimport によるプロジェクトのインポートが完了すると、結果を確認できるようになります。
アエル プロジェクトの歴史 と アエル 変更詳細 コマンド。 （見る アエル（1）詳細
情報。）

製品制限
aeimport プログラムは完璧とは程遠いです。 既知の制限が多数あります。

· 現時点では、分岐はサポートされていません。 (やり方が分かり次第、
疎結合ファイル間のブランチのルートを識別するには、それを実装します。 アイデア
および/またはコードの貢献を歓迎します。)

· 現時点では RCS 形式と SCCS 形式のみが理解されています。 それはすぐに進むはずです
将来的には他の形式のサポートも追加します。 上記の手順のステップ 1 のみ
注意が必要ですが、残りはファイル形式に依存しません。

· CVS モジュールはサポートされておらず、サポートされる必要があります。

· 変更セットを決定するために使用される時間枠のサイズを指定することはできません。 時が教えてくれる
これが必要かどうかはわかりませんが、ウィンドウ サイズをどうやって知ることができるのかという疑問が生じます。
このオプションを使用するには必要があります。

· CVS リポジトリを既存のプロジェクトにインポートすることはできません。 新しいもののみ作成できます
CVS リポジトリからのプロジェクト。

· リモート CVS リポジトリをインポートすることはできません。

OPTIONS

次のオプションが理解されます。

-ディレクトリ path
このオプションは、使用するディレクトリを指定するために使用できます。 エラーです
現在のユーザーがディレクトリを作成するための適切な権限を持っていない場合
与えられたパス。 これは絶対パスである必要があります。

注意: オートマウンタを使用している場合は、絶対マウントを作成するために「pwd」を使用しないでください。
通常、間違った答えが得られます。

-フォーマット 名
このオプションは、どの履歴形式をインポートするかを指定するために使用できます。 の
次の形式が理解されます。

RCS Release Control System フォーマットはかなり前から存在しています。 それは
CVS (Concurrent Version System) の基礎となる形式。 これは
形式名が指定されていない場合のデフォルト。
ご注意: フォーム しなければなりません 実行する前に RCS をインストールしてください インポート これを使用する場合
RCS コマンドはインポート プロセス中に実行されるため、この形式になります。 の
RCS がインストールされていない場合、インポートは失敗します。 フリーウェアを見つけることができます
ftp.gnu.org での実装、またはローカルミラー。

SCCS ソース コード管理システムは、最も初期の Unix バージョン システムの XNUMX つです。
(これは BitKeeper の基礎となる形式だと聞きました。)
ご注意: フォーム しなければなりません 実行する前に SCCS をインストールしておく インポート あなたが使うなら
インポート プロセス中に SCCS コマンドが実行されるため、この形式になります。
SCCS がインストールされていない場合、インポートは失敗します。 GNU の互換性のある愚かさ
ソース コントロール (CSSC) は、SCCS のフリーウェア実装であり、
見つけた ftp://alpha.gnu.org/gnu/CSSC/

-図書館 棄権
このオプションは、グローバル状態を検索するディレクトリを指定するために使用できます。
ファイルとユーザー状態ファイル。 （見る エーグステート（5）と オーステート（5）詳細
) いくつかのライブラリ オプションがコマンド ラインに存在する場合があります。
指定された順序で検索されます。 この明示的な検索パスに追加されるのは、
で指定されたディレクトリ AEGIS_PATH 環境変数 (コロン区切り)、
そして最後に、 /usr/local/lib/aegis 常に検索されます。 すべてのパスが指定されており、
コマンドラインまたは AEGIS_PATH 環境変数は次のように指定する必要があります
絶対。

-リスト
このオプションは、このコマンドに適したサブジェクトのリストを取得するために使用できます。
リストは予想よりも一般的かもしれません。

-事業 名
このオプションは、関心のあるプロジェクトを選択するために使用できます。 いいえの場合 -事業
オプションが指定されている場合、 AEGIS_PROJECT 環境変数が参照されます。 もしも
それは存在しません、ユーザーの $ HOME / .aegisrc ファイルはデフォルトで検査されます
プロジェクトフィールド（を参照） aeuconf（5）詳細については）。 それが存在しない場合は、
ユーザーが単一のプロジェクト内の変更のみに取り組んでいる場合、プロジェクト
nameのデフォルトはそのプロジェクトです。 それ以外の場合はエラーです。

-ヘルプ
このオプションは、使用方法に関する詳細情報を取得するために使用できます。 インポート
プログラム。

-バージョン 数
このオプションは、プロジェクトのバージョン番号を指定するために使用できます。 バージョン
数値は分岐として実装されます。 次の場合は、単一のダッシュ (「-」) を引数として使用します。
バージョンブランチを作成しないようにします。

参照 イージス（1）すべてのaegisコマンドに共通のオプション。

すべてのオプションは省略できます。 略語は大文字として文書化されていますが、
すべての小文字とアンダースコア（_）はオプションです。 連続して使用する必要があります
オプションの文字のシーケンス。

すべてのオプションでは大文字と小文字が区別されません。大文字または小文字、あるいは
両方の組み合わせ、ケースは重要ではありません。

例：引数「-project」、「-PROJ」、「-p」はすべて、
-事業 オプション。 引数「-prj」は連続しているため理解できません
オプションの文字は提供されませんでした。

オプションおよびその他のコマンドライン引数は、コマンドラインで任意に混在させることができます。
関数セレクターの後。

GNUの長いオプション名は理解されています。 すべてのオプション名が インポート 長いです、
これは、余分な先頭の「-」を無視することを意味します。 NS "--オプション=値「コンベンションも
理解した。

EXIT ステータス

この インポート コマンドは、エラーが発生するとステータス1で終了します。 NS インポート command
エラーがない場合にのみ、ステータス0で終了します。

ENVIRONMENT 変数

見る イージス（1）このコマンドに影響を与える可能性のある環境変数のリスト。 見る
aepconf（5）プロジェクト構成ファイルの場合 プロジェクト固有 設定方法のフィールド
Aegisによって実行されるすべてのコマンドの環境変数。

COPYRIGHT

aeimport バージョン 4.24.3.D001
Copyright（C）1991、1992、1993、1994、1995、1996、1997、1998、1999、2000、2001、2002、
2003、2004、2005、2006、2007、2008、2009、2010 Peter Miller

aeimport プログラムには絶対的な保証がありません。 詳細については、「」を使用してください。インポート
-バージョン ライセンス' 指図。 これは無料のソフトウェアであり、再配布することを歓迎します
特定の条件下で; 詳細については、 'を使用してくださいインポート -バージョン ライセンス' コマンド。

onworks.net サービスを使用してオンラインで aeimport を使用する