home *** CD-ROM | disk | FTP | other *** search
/ FreeWare Collection 3 / FreeSoftwareCollection3pd199x-jp.img / oh_fm / ccheck / chk.txt < prev    next >
Text File  |  1980-01-02  |  6KB  |  106 lines
  1. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  2.                           Ｃソースコードチェックサム               
  3. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  4.  
  5. for FM-7,77,AV,8,11,16,R-30/50/60/70/80,TOWNS+Cコンパイラ
  6.  
  7.   Ｃのライブラリをペーパーメディアで提供した場合，タイプミスが発生する可能性
  8. がかなりあり，タイプミスをチェックするなんらかの仕組みが必要となります。オブ
  9. ジェクトをダンプで掲載する場合はマシン語のチェックサムがそのままそれに使えま
  10. すが，ソースの場合は別途何かを用意しなければなりません。Ｏｈ！ＦＭ掲載Ｃのソ
  11. ースプログラムの場合は，リストの脇に必ず「Ｃソースコードチェックサム」が用意
  12. されています。Ｃ関連の記事を活用するさいにで必ず使うものですので，この機会に
  13. 使い方を覚えておいてください。
  14.   動作概要はＯｈ！ＦＭ掲載のＢＡＳＩＣプログラムでおなじみのＢＡＳＩＣチェッ
  15. クサムと同じで，リスト上の１行中の文字をＡＳＣＩＩコードに勘算して演算し，そ
  16. の結果の16進下２桁をチェックサムとして使うものです。ただ，Ｃの特徴に合わせて
  17. たため，ＢＡＳＩＣチェックサムとは一部仕様が異なっていますので注意してくださ
  18. い。
  19.  
  20. ●仕様
  21.  
  22.   このＣソースコードチェックサムは，以下のような仕様に基づきチェックサムを算
  23. 出します。
  24. 　　１．ＡＳＣII形式のテキストファイルを取り扱い，改行記号から改行記号までの
  25. 　　　　間を１行として，１行ごとにサムを算出する
  26.   　２．テキスト先頭を1010番とし，以降10番ずつ増える行番号で行位置を示すが，
  27. 　　　　テキストファイル自体は，通常ＭＳ-DOSテキストでも, 行番号＋｢'｣のＦ-BA
  28.         SICのＲEM文形式でもどちらでもよく， サムの計算自体には行番号は含めな
  29.         い（行の先頭に数字がある場合，その数字を行番号の始まりと見なして，｢'｣
  30.         が現われるの間を行番号として計算に含めないので，ＲEM文形式しないとき
  31.         は数字から始めないこと）
  32.     ３．各行のサムは，計算対象の各文字のＡＳＣIIコードと文字位置（行先頭から
  33.         の文字数）の排他的論理和(XOR)の値を順に加算していき， その結果の16進
  34.         下２桁をとることで算出する（そのため｢ABC｣と｢CBA｣は違う値になる）
  35.     ４．注釈は，前後の ｢/*｣｢*/｣ を含めて読み飛ばので，とくに入力する必要はな
  36.         いが，行数がずれるとサムが狂うので，最低限空の行は入れること
  37.     ５．｢″｣または｢′｣によって囲まれている部分以外の空白は読み飛ばすので，ス
  38.         ペースの数がリストどおりになっていなくてもサムは同じになる
  39.     ６．インラインアセンブラのソース部分では，行末の注釈部分と｢＊｣で始まる行
  40.         は加算しない  
  41.         注１）注釈部分の先頭には１つ以上の空白と｢；｣がなくてはならない  
  42.         注２）オペランド部分の文字列定数は｢″｣か｢/｣で前後を囲まなくてはならな
  43.               ず，また，その前に１つ以上の空白がなければならない。
  44.     ７．インラインアセンブラの開始／終了は，プリプロセッサ命令#asm ／#endasm
  45.         による（大文字は使用できない）
  46.     ８．各行のサムは算出結果の16進の下２桁をとるものとする
  47.     ９．表示は１列10個，10列で１ブロックとする
  48.     10．計算の対象となる文字がない行(注釈行，空行)の値は｢--｣で表わし，計算し
  49.         た結果｢00｣になった行とは区別する。
  50.     11．表示したサムの縦と横の和をとって16進下２桁をブロックの下と右横に表示
  51.         し，さらにその和を右下に表示する
  52.     12．チェックサムの右側には，チェックするときの目安として，チェックサム列
  53.         の先頭の行の前から１６文字が表示される
  54.  
  55. ●使い方
  56.  
  57.   MS-DOSのコマンドライン(ORICON等のコンソ－ルでも可)から,
  58.          chk  [-ｵﾌﾟｼｮﾝ]  <ﾌｧｲﾙ名>                
  59. として利用ください。ファイル名を指定しなかった場合には，標準入力から読み込み
  60. ますから，パイプにつないで使用することもできます。
  61.   チェックサムの出力は，オプションを指定しない場合は，標準出力に行われます。
  62. リダイレクトを使って，
  63.       chk  A:File1 >PRN  
  64. のように，該当するデバイスやファイルに出力することができます。
  65.   オプションを付けた場合は，以下のようなかたちで出力されます。
  66.     -p：プリンタにチェックサムが印字される(OS-9では標準エラー出力にチェック
  67.         サムが送られる)
  68.     -ｌ：ソースに行番号が付いている場合，行番号を外してリストを出力する
  69.     -ｎ：行番号を付けてリスト出力する
  70.     -ｃ：行番号と，その直後にその行のサム（｢'0xx '｣のように，｢'｣のあとに識別
  71.          用の０とサムの値を続ける）を付けてリストを出力する。
  72.     -ｆ：-ｆ＝file nameの形式で指定ファイルに出力し，既に同じ名前のファイル
  73.          が存在するときは古いファイルの上の上書きする（ＤracoＣ用の対策)。
  74. これらのオプションのうち，-ｌ,-ｎ,-ｃは同時に指定できず， また-ｐと-ｌも同時
  75. には使えませんが，それを除けば
  76.       chk  -pn  file2  
  77. のように組み合わせて指定できます。
  78.   さて，こうして得られたチェックサムを雑誌掲載のものと比べて，タイプミスした
  79. 行がないかどうか捜すのはＢＡＳＩＣチェックサムと同じ要領ですが，オプション-ｌ,
  80. -ｎ,-ｃを活用すると 便利です。そのやり方は……。
  81.   まず，ソースを打ち込みます（Ｄraco Ｃでは行番号＋｢'｣のＲEM文形式で，それ以
  82. 外は行番号ヌキで）。次にオプションなしでｃｈｋを使い，本誌掲載のものとチェッ
  83. クサムを比べます。間違いがあったら，今度は-ｃｆ＝file nameでｃｈｋを起動して，
  84. 行番号／チェックサム付きのファイルを作ります。そのファイルをエディタに吸い上
  85. げて，チェックサムの異なっている行を修正します。修正作業が終わったら，またオ
  86. プションなしでチェックサムをとり，間違いがあったらもう一度-ｃｆ付き でリスト
  87. を作り……と修正作業を繰り返します。間違いがなくなったなら， -ｌオプションで
  88. 行番号を外したファイルを作ります(ＤracoＣでは-ｎオプションで行番号だけを付け
  89. たファイルを作ります）。
  90.     ＊        ＊          ＊        ＊        ＊
  91.   ＢＡＳＩＣチェックサムをお使いの方はわかると思いますが，このＣソースコード
  92. チェックサムは全能ではないにしても，かなりのケアレスミスをチェックできます。
  93. このツールを活用して，ライブラリに蓄積に役立ててください。
  94.   最後に，Ｄｒａｃｏ／ＭＷ／ＭＳの３種類のコンパイラ上で共通に走るようにした
  95. ために, ソ－スに必要以上に冗長なところのあるプログラムですが、気にしないでく
  96. ださいね（単にプログラミングの才能がないだけだったりする……）。
  97.  
  98.  
  99.   このプログラムの著作権はＯｈ！ＦＭ編集部が保持しておりますが，著作権法
  100. の定める「個人的な利用」の範疇であれば自由に利用してくださってけっこうで
  101. す。また，転載・配布についても事前の許諾なしに自由に行ってくださってかま
  102. いません。ただし配布時に，
  103.       1.  Ｏｈ！ＦＭ掲載プログラムであること
  104.       2.  自由転載許可に基づいて転載・配布したものであること
  105. の旨を，説明用のテキストに明記してください。
  106.