home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 2003 August / VPR0308.ISO / OLS / BGA32037 / bga32037.lzh / SDK / Bga32Cmd.txt < prev   
Text File  |  2002-06-04  |  15KB  |  397 lines
  1. ==========================================================================
  2.                Bga32.dll version 0.37  コマンド説明ファイル
  3.                                                               木村 利靖
  4.                                                        Toshinobu Kimura
  5. ==========================================================================
  6.  
  7. 0.  はじめに
  8. 1.  コマンドラインの様式
  9. 2.  命令の詳細
  10. 3.  スイッチオプションの詳細
  11. 4.  基底ディレクトリについて
  12. 5.  作業ファイル名
  13. 6.  書庫の形式
  14.  
  15. --------------------------------------------------------------------------
  16.  
  17. 0. はじめに
  18. ===========
  19.  
  20.     Bga32.dll では、独自形式の書庫 .GZA、.BZA ファイルに関して、次の操作が
  21.     可能です。
  22.  
  23.     (1) 書庫を新規に作成する( マルチボリュームファイルは作成できません )
  24.     (2) 既存の書庫へファイルを後から追加する( 移動も可能 )
  25.     (3) 既存の書庫に格納されているファイルを新しいファイルで更新する
  26.     (4) 既存の書庫に格納されているファイル名を変更する
  27.     (5) 既存の書庫に格納されているファイルを個別に削除する
  28.     (6) 既存の書庫から指定( あるいは全て )のファイルを解凍する
  29.     (7) 既存の書庫に格納されているファイルの情報を取得する
  30.     (8) 自己解凍形式書庫を作成する
  31.  
  32.  
  33. 1. コマンドラインの様式
  34. =======================
  35.  
  36.  [<command>] [-<switch>...] <archive_file_name>[.GZA|BZA]
  37.     [<base_directory_name>\] [[<path_name>|<file_name>|<wild_name>]...]
  38.  
  39.   command 及び switch は大文字・小文字を区別しません。
  40.   command はコマンドラインの最初の引数としてください。なお、command を省略
  41.   した場合は 'x' command が指定されたものとみなします。
  42.  
  43.   switch の位置については、その指定位置を問いません。'-' につづいて指定された
  44.   文字を switch とみなします。複数の switch を指定する場合には switch ごとに
  45.   分けて '-' で指定してください。
  46.  
  47.   BgaConfigDialog() で指定されている switch を無効にするには switch 文字の後に
  48.   '-' を記述します。
  49.   例えば r switch を無効にするには "-r-" とします。
  50.   無効にできる switch は a、i、j、n、o、r の各 switch です。
  51.  
  52.   コマンドラインの command、switch 以外の最初の文字列を archive_file_name と
  53.   みなします。archive_file_name は省略できません。
  54.   archive_file_name にはワイルドカードが指定できますが、'a', 'd', 'm', 'n' の
  55.   各 command 時には、ワイルドカードは使用できません。
  56.  
  57.   書庫を新規に作成する場合には archive_file_name の指定で拡張子を省略できます
  58.   が、省略する場合には '-m' switch で書庫の種別を指定する必要があります。
  59.   また、ひとつの書庫での圧縮種別は統一されなければなりません。既存の書庫への
  60.   追加圧縮時には、指定された拡張子や '-m' switch での指定にかかわらず、既存の
  61.   書庫と同一の種別で圧縮します。
  62.  
  63.   前提として、書庫の拡張子が ".GZA" であれば GZIP で圧縮した書庫、".BZA" なら
  64.   BZIP2 で圧縮した書庫と仮定します。ただしこれは既定値であり、他の拡張子を
  65.   指定してもかまいません。このときには '-m' switch で書庫の種別を指定します。
  66.   ただ、別の拡張子を使用した場合には見た目で書庫かどうかの判断がつきにくく
  67.   なりますのであまりお勧めしません。
  68.   なお、自己解凍形式書庫を指定する場合には拡張子は省略できません。
  69.  
  70.   base_directory_name( 基底ディレクトリ )はひとつだけ指定できます。
  71.   base_directory_name を指定する場合には、パス名を必ず '\' で
  72.   終わらせて指定しなければなりません。
  73.   base_directory_name を省略した場合には、カレントディレクトリを基準にします。
  74.  
  75.   <path_name>|<file_name>|<wild_name> には操作を行うパス名またはファイル名を
  76.   指定します。
  77.  
  78.   path_name の形式で指定すると、指定のディレクトリを含めて書庫に格納します。
  79.   file_name の形式で指定すると、指定のファイルを書庫に格納します。
  80.  
  81.   最初の文字が '@' であれば、それに続くファイル名をレスポンスファイルとして
  82.   扱います。
  83.   レスポンスファイルにファイルリストを記述する場合には、テキスト１行に１
  84.   ファイルづつ記述するか、１行に複数のファイルを納める場合には、各ファイル
  85.   名は空白( 0x20 )で区切ります。ファイル名自体に空白が含まれる場合には、
  86.   そのファイル名は '"' (ダブルクォーテーション) で括らなくてはなりません。
  87.   また、１行に記述できるファイルのリストは、文字列長で1024バイト未満です。
  88.   複数行で指定する場合には、１行の限度は上記のとおりですが、行数の限度は
  89.   ありません。
  90.   なお、レスポンスファイルには switch や base_directory_name は記述でき
  91.   ません。また、レスポンスファイル中にレスポンスファイルを呼び出すような
  92.   記述もできません。この場合には '@' で始まるファイル名として認識されます。
  93.  
  94.   wild_name は MSDOS の慣習に従います。"*.*" は全てのディレクトリ、ファイルを
  95.   意味します。"*.DOC" は ".DOC" の拡張子を持つファイルを意味します。"?A*.*"
  96.   は２文字目に 'A' を持つファイルを意味します。
  97.   <path_name>|<file_name>|<wild_name> がない場合は "*.*" が指定されたものと
  98.   みなします。
  99.  
  100.   スペースを含むファイル名のファイルを扱いたい場合は '"'  で括るようにしま
  101.   す。括られていない場合は複数の文字列と判断されます。'"' で括る際は、以下
  102.   の例における switch 指定のようにパラメータ全てを括るようにしてください。
  103.  
  104.       例 : n c:\test.bza "Original Name.txt" "-fChange Name.txt"
  105.  
  106.  
  107. 2. 命令の詳細
  108. =============
  109.  
  110.   a: 書庫にファイルを追加
  111.   -----------------------
  112.  
  113.     ファイルを圧縮して書庫に追加します。書庫が存在しなければ新しく作成
  114.     します。書庫の中に同じ名前のファイルがある場合は、無条件に上書きで
  115.     圧縮します。ただし "-n" switch が指定されていれば日付の新しいファイル
  116.     だけを更新します。
  117.     "-r" switch が指定されていれば、指定されたワイルド名に合致する
  118.     ようなサブディレクトリのすべてのファイルを追加します。
  119.  
  120.     例：    a -r archive subdir\ *.*
  121.         subdir\ 以下のすべてのファイルを圧縮して格納
  122.  
  123.   d: 書庫からファイルを削除
  124.   -------------------------
  125.  
  126.     書庫からファイルを削除します。指定されたファイルは書庫から物理的に
  127.     削除します。このときファイル毎に削除確認を行ないます。
  128.     ただし、"-i" switch を指定すれば、削除確認を行いません。
  129.  
  130.     例：    d archive *.c
  131.         ".c" で終わるファイルを確認付きで削除
  132.  
  133.   j: 自己解凍書庫を通常の書庫へ変換
  134.   ---------------------------------
  135.  
  136.     既存の自己解凍書庫を通常の書庫へ変換します。
  137.     通常の書庫は、指定した自己解凍書庫の拡張子( .exe )を書庫の形式に応じて
  138.     .bza か .gza に変更した名前で作成します。
  139.     すでに同名の書庫が存在する場合は無条件に置換しますので注意が必要です。
  140.  
  141.     例：    j archive.exe c:\tmp\
  142.           archive.exe を変換して C:\TMP 上に通常の書庫 archive.bza または
  143.           archive.gza を作成。
  144.  
  145.   l: 書庫の内容を短い形式で一覧表示
  146.   ---------------------------------
  147.  
  148.       書庫の格納ファイルの一覧を表示( szOutputに出力)します。
  149.  
  150.   m: 書庫にファイルを移動
  151.   -----------------------
  152.  
  153.     'a' command と同様にファイルを圧縮して書庫に追加しますが、追加の後、
  154.     追加されたファイルを削除します。
  155.     ただしディレクトリは削除しません。
  156.  
  157.   n: 書庫の中のファイル名の変更
  158.   -----------------------------
  159.  
  160.     書庫に格納されているファイル名を変更します。選択されたファイル毎に
  161.     新しいファイル名を催促します。
  162.     キャンセルすると、そのファイルについてはファイル名を変更しません。
  163.     '/' の文字を使用することにより、ディレクトリ情報の埋めこみや変更が
  164.     行えます。また、長いファイル名やスペースを含んだファイル名の入力も
  165.     可能です。
  166.  
  167.     例：    n archive file1
  168.           archive 内の file1 というファイル名を変更します。
  169.  
  170.   s: 自己解凍書庫の作成
  171.   ---------------------
  172.  
  173.     既存の通常書庫から自己解凍書庫を作成します。
  174.  
  175.     例：    s archive c:\tmp\
  176.           archive を変換して C:\TMP 上に自己解凍書庫 archive.exe
  177.           を作成。
  178.  
  179.   t: 書庫の検査
  180.   -------------
  181.  
  182.     選択されたファイルのヘッダを検査します。
  183.     圧縮データの正当性はチェックしません。
  184.  
  185.   v: 書庫の内容を長い形式で一覧表示
  186.   ---------------------------------
  187.  
  188.       書庫の格納ファイルの一覧を表示( szOutputに出力)します。
  189.  
  190.   x: ファイルを展開
  191.   -----------------
  192.  
  193.     書庫から１個以上のファイルを、カレントディレクトリか、指定されていれば
  194.     基底ディレクトリに展開します。
  195.     "-n" switch が指定されていれば日付をチェックして新しいファイルだけを
  196.     解凍します。また、"-o" switch が指定されていれば、同じ名前のファイルが
  197.     あれば無条件に上書きします。
  198.     "-n" switch も "-o" switch も指定されていなければ、既に存在するファイル
  199.     に上書きする前にユーザに確認します。(1)上書き、(2)新しいファイルのみ、
  200.     (3)上書きしない の３つから処理を選択できます。
  201.  
  202.  
  203. 3. スイッチの詳細
  204. ===========================
  205.  
  206.   -: レスポンスファイル文字の指定
  207.   -------------------------------
  208.  
  209.     例えば --! とすると、以降では !resp という形式でレスポンスファイルを指定す
  210.     ることになります。単に -- とだけ指定すると、レスポンスファイルを使用できな
  211.     くなります。
  212.  
  213.   a: 全属性を圧縮・解凍の対象とする
  214.   ---------------------------------
  215.  
  216.     デフォルトでは、リードオンリー属性のついたファイルはそのまま格納
  217.     しますが、隠し属性・システム属性のついたファイルを格納しません。
  218.     この switch を指定すると、隠し属性・システム属性のついたファイルも
  219.     格納するようになります。
  220.     また、単独のディレクトリ名も格納します。ただしディレクトリ名のメンバを
  221.     作成するには、
  222.                    a -a archive c:\ tmp\*.*
  223.     ではなく、
  224.                    a -a archive c:\ tmp
  225.     のように指定する必要があります。
  226.  
  227.     なお、この switch は解凍時にも有効です。
  228.     解凍時に指定すると、隠し属性・システム属性のついた格納ファイルも解凍
  229.     します。また、格納されている空のディレクトリも解凍します。
  230.  
  231.   f[<ファイル名>]: 変更ファイル名を供給
  232.   -------------------------------------
  233.  
  234.     'n' command 時には変更するファイル名をユーザが指定するダイアログを表示
  235.     しますが、この switch を指定することにより、コマンドラインから直接
  236.     ファイル名を指定できます。格納ファイルの指定にワイルドカードを使った
  237.     場合、マッチしたすべてのファイルが同じ名前に変更されてしまうので、
  238.     注意を要します。
  239.  
  240.     個別に変名を行いたい場合には BgaSetEnumMembersProc() を使用してください。
  241.  
  242.           例：  n archive file1 -fChangeName.TXT
  243.         "file1" を "ChangeName.TXT" に変更する。
  244.  
  245.                 n archive file2 "-fChange Name.TXT"
  246.         "file2" を "Change Name.TXT" に変更する。
  247.  
  248.   i: サイレントモード
  249.   -------------------
  250.  
  251.     書庫の作成・解凍時に、進捗状況を示すウィンドウを表示しません。
  252.     'd' command 時には削除の確認を行わなくします。
  253.  
  254.     例  x -i -j archive c:\ *.cpp
  255.  
  256.   j: ディレクトリを無視して解凍
  257.   -------------------------
  258.  
  259.     書庫にパス名とともに格納されているファイルを、パス名を無視して、
  260.     基底ディレクトリへ解凍します。
  261.  
  262.     例  x -j archive c:\ *.*
  263.  
  264.   l: 圧縮レベルの指定
  265.   -------------------
  266.  
  267.     圧縮時の圧縮レベルを指定します。1 - 9 で指定できます。
  268.     一般に数値が小さいほど処理速度は速くなりますが圧縮率は低下し、
  269.     大きくなるほど処理速度は遅くなりますが圧縮率が上がります。
  270.     デフォルトは '9' です。
  271.  
  272.     ※BZIP2 形式の場合、圧縮するファイルによっては、レベルが小さいほうが
  273.       圧縮率が良いこともあるようです。
  274.  
  275.     例  a -l6 archive c:\temp\ *.*
  276.  
  277.   m: 圧縮方式の指定
  278.   -----------------
  279.  
  280.     書庫を新規作成するとき、archive_file_name の指定で拡張子を省略した場合、
  281.     圧縮方式を GZIP にするか BZIP2 にするかを指定します。
  282.  
  283.     archive_file_name の指定に有効な拡張子が含まれていればこのオプションは
  284.     無視します。また、既存の書庫に対する操作時にも無効です。
  285.  
  286.     -m1 : GZIP  で圧縮
  287.     -m2 : BZIP2 で圧縮
  288.  
  289.   n: 新しいファイルのみ圧縮・解凍
  290.   -------------------------------
  291.  
  292.     圧縮する場合には、書庫内に同じ名前のファイルが存在する場合に、
  293.     ファイルの更新日時を比較して、新しいもののみを圧縮して置き換えます。
  294.     解凍する場合には、解凍先ディレクトリに既に同じ名前のファイルが存在する場合
  295.     に、ファイルの更新日時を比較して、新しいもののみを解凍します。
  296.  
  297.     例  x -n archive c:\ *.doc
  298.  
  299.   o: 無条件に上書きで解凍
  300.   -----------------------
  301.  
  302.     解凍する際に、解凍先ディレクトリに既に同じ名前のファイルが存在しても
  303.     強制的に上書き解凍します。
  304.  
  305.     例  x -o archive c:\ *.doc
  306.  
  307.   r: サブディレクトリも検索
  308.   ---------------------
  309.  
  310.     格納すべきファイルの指定にワイルドカードが指定されていた場合、ワイルド
  311.     カードに一致するディレクトリの階層下に含まれるディレクトリも再帰的に検索し
  312.     て書庫に格納します。
  313.     このスイッチは解凍時にも有効です。
  314.  
  315.  
  316. 4. 基底ディレクトリについて
  317. ===========================
  318.  
  319.     基底ディレクトリは、ファイルを圧縮・展開する際に基準とするディレクトリです。
  320.     これを指定することで、対象とするすべてのファイルにパスを記述する必要が
  321.     なくなります。
  322.  
  323.     例1  a arc_file "c:\Program Files\work\" file1.txt file2.txt
  324.  
  325.         c:\Program Files\work 配下の file1.txt と file2.txt を格納する。
  326.         この場合、格納情報には work ディレクトリは含まれません。
  327.  
  328.     例2  a -r arc_file "c:\Program Files\" work\file1.txt work\file2.txt
  329.  
  330.         c:\Program Files 配下の work\file1.txt と work\file2.txt を
  331.         格納する。
  332.         この場合、格納情報には work ディレクトリが含まれます。
  333.  
  334.  
  335. 5. 作業ファイル名
  336. =================
  337.  
  338.     圧縮や解凍時に、テンポラリディレクトリに Bga00tmp.tmp というファイルを作成
  339.     します。
  340.     通常は作業の終了時に削除しますが、不正終了してしまった場合などには残骸が
  341.     残りますので、手動で削除してください。
  342.  
  343.  
  344. 6. 書庫の形式
  345. =============
  346.  
  347.     A) .GZA
  348.  
  349.         対象ファイルをそれぞれ gzip で圧縮し、それぞれに Bga32.dll の独自
  350.         ヘッダを付加して結合しただけのファイルです。
  351.  
  352.         test1.txt, test2.txt からひとつの書庫( test.gza )を作成する場合、
  353.         書庫作成の内部的な手順は以下のようになります。
  354.  
  355.         1) 各ファイルを gzip で圧縮 :
  356.             test1.txt -> test1.gz
  357.             test2.txt -> test2.gz
  358.         2) 各ファイルに Bga32.dll の独自ヘッダを付加 :
  359.             test1.gz -> header1 + test1.gz
  360.             test2.gz -> header2 + test2.gz
  361.         3) すべての圧縮ファイルを結合して書庫を作成 :
  362.             ( header1 + test1.gz ) + ( header2 + test2.gz ) -> test.gza
  363.  
  364.     B) .BZA
  365.  
  366.         対象ファイルをそれぞれ bzip2 で圧縮し、それぞれに Bga32.dll の独自
  367.         ヘッダを付加して結合しただけのファイルです。
  368.  
  369.         test1.txt, test2.txt からひとつの書庫( test.bza )を作成する場合、
  370.         書庫作成の内部的な手順は以下のようになります。
  371.  
  372.         1) 各ファイルを bzip2 で圧縮 :
  373.             test1.txt -> test1.bz2
  374.             test2.txt -> test2.bz2
  375.         2) 各ファイルに Bga32.dll の独自ヘッダを付加 :
  376.             test1.bz2 -> header1 + test1.bz2
  377.             test2.bz2 -> header2 + test2.bz2
  378.         3) すべての圧縮ファイルを結合して書庫を作成 :
  379.             ( header1 + test1.bz2 ) + ( header2 + test2.bz2 ) -> test.bza
  380.  
  381.  
  382.     ※上記から判るように、.GZA、.BZA どちらも書庫ヘッダは保持しません。
  383.       そのため、MS-DOS の copy コマンドで複数の同一形式の書庫を結合して
  384.       新しい書庫を作成することができます。
  385.  
  386.       ex)
  387.         C>copy /b test1.bza+test2.bza test3.bza
  388.         C>copy /b test4.gza+test5.gza test6.gza
  389.  
  390.       ただし、以下の例のように異形式を混在して結合した書庫は Bga32.dll の
  391.       現状の仕様に反しているため、以後この書庫に対する各種操作の正常な動作は
  392.       保証されません。ご注意ください。
  393.  
  394.         C>copy /b test1.bza+test4.gza test7.bza
  395.  
  396. ==========================================================================
  397.