The GNU-WIN32/CYGWIN32 FAQ and protomanual 19 for release b19. (Japanese)

これは何ですか?

GNU-Win32 ツールは、広く普及している GNU の開発ツールを、Windows NT/95 用に移植したものです。これらのプログラムは、それらが必要としている UNIX システムコールや環境を提供する Cygwin32 ライブラリによって動作します。

これらのツールをインストールすることによって、標準 Microsoft Win32 APIおよび Cygwin32 API を使っての Win32 コンソールアプリケーション、または GUI アプリケーションの作成が可能になりました。この結果、たくさんの重要な UNIX プログラムを、大規模なソースコードの修正をすることなく容易に移植することが可能になります。これはほとんどの GNU ソフトウエアの configure とビルドも含みます(gnu-win32 開発ツール自身に入っているパッケージも含まれます)。開発ツールがあなたにとってあまり役に立たなくても、このパッケージで提供されるたくさんの UNIX 標準ユーティリティに興味を持たれるかも知れません。これらは (同時に提供される)bash シェル、 command.com のどちらからでも使用できます。

これはフリーソフトウェアですか?

はい。いくつかは GNU のソフトウェア(gcc、gas、ld、など)で、いくつかは Berkeley license などのライセンスに含まれます。シェアウェアではありません。あなたはこれを使用するために、誰かにお金を支払う必要はありません。あなたがこれらのツールを使用する上で、GNU General Public License がどのように影響を与えるかについての詳細な情報は、この FAQ の copyright の項を参照してください。

プロジェクトの簡単な歴史

最初は開発ツール(gcc、gdb、gas など)の強化が行われました。これで Win32 ネイティブオブジェクトファイルの生成、解釈ができるようになりました。

次の仕事はツールを Win NT/95 に移植することでした。これはソースの大部分を Win32 API の文脈で動作するように書き換えることでもできたでしょう。しかしこれでは、それぞれのツール全てに対して膨大な時間を費やすことになってしまいます。その代りに私たちは、共有ライブラリ(cygwin.dll)を書くという全く異なったアプローチを取ることにしました。これは必要な unix 風の機能でWin32 API に不足しているもの(fork、spawn、シグナル、select、ソケットなど) を追加する、というライブラリです。私たちはこの新しいインタフェースを Cygwin32 API と呼んでいます。一旦これが書かれたあとは、unix 上でクロスコンパイラを使って、このライブラリをリンクして、動作する Win32 ツールをビルドすることが可能になりました。

この時点で私たちは、 Windows 95/NT 上で自分自身を再構築することができるネイティブツールの作成、という目標を達成しました(これはよくセルフホスティングと呼ばれます)。どちらの OS にも UNIX の標準ユーザツール(fileutils, textutils, bash などなど)は付属していないので、私たちは Cygwin32 API で動作する同等の GNU ツールを手にしなければなりませんでした。これらのツールのほとんどは以前はそれ専用にビルドされていたので、configure スクリプトをクロスコンパイルできるように修正しなければなりませんでした。configuration の変更以外にも、ごく僅かのソースレベルの変更も必要でした。bash が開発ツールやユーザツールと一緒に正しく動いていると、Windows 95も NT も、GNU configure 機構を通して見ると UNIX の一種のように見えます。セルフホスティングは beta 17.1 リリース以降で達成されました。

beta 19 リリースノート

Release Beta 19 (Feb 26 1998)

これは重要なリリースです。これにはさらに新しいバージョンの Cygwin32 ライブラリが含まれています。Cygwin API は互換性のなくなる変更がなされたので、dll の名前は cygwinb19.dll に変更されました。これは以前に作成された実行プログラムを無効にしないようにするためです。

B19 でコンパイルされたアプリケーションが B18 でコンパイルされたアプリケーションを exec() するときは、B18 でコンパイルされた実行プログラムは普通の Win32 実行プログラムとして扱われることに注意してください。これはつまり、オープンしたファイルディスクリプタやその他の内部データは exec() 呼び出しにおいて継承されないということです。この理由は、cygwin ライブラリのバージョンの違いによって違った共有メモリ領域が使用されるからです。これはあなたのやろうとしていることによっては重大かも知れませんし、そうでないかも知れません。

Cygwin32 ライブラリの Beta 19 リリースは、引き続き GNU General Public License (GPL) に従ってライセンスされます。

コンパイラツールで使用される PE 形式の定義は、Microsoft のものにより近くなりました。これによって他のベンダの開発ツールとの間でより共同利用できるようになるでしょうが、しかしおそらくこの領域についてはまだまだやるべきことが多く残っているでしょう。この変更によって、以前作成されたオブジェクトファイル(.o)やスタティックライブラリファイル(.a)が使えなくなりますので、必要なものは忘れずに古い .o と.a ファイルを消して作成し直してくださいね!

最後に、古いシンボリックリンクはこのリリースで無効になります。 "system" 属性がシンボリックリンクの印として使われるようになり、これで fstat と他のファイル関連の呼び出しが非常にスピードアップされました。古いシンボリックリンクを作り直すか、あるいはそれらの "system" 属性フラグをセットすることで、正しく認識されるようになるでしょう。

新しいインストーラは、 program files のショートカットをインストールすることで全ての環境変数の設定を自動的に行います。このショートカットは全ての環境変数を正しく設定して bash プロンプトを立ち上げます。この結果、セットアップ処理は前回のリリースよりもよりきれいになりました。

ツールを最終的には移動させる人のために、デフォルトの環境変数を設定するバッチファイルが、 cygnus.bat という名前でインストールディレクトリのルートにインストールされます。ツールは/cygwin/b19 にインストールするようにコンパイルされているので、この場所にインストールしたときは、 bin ディレクトリがパスに入っていれば各ツールは「それだけで動く」はずです(特別な環境変数は何も必要ありません)。唯一の例外は、MAKE_MODE で、これは通常の UNIX風の make の振る舞いをさせたい場合に設定する必要があります - さらに詳しくは以下の make のノートを参照してください。

各ツール毎の変更:

Ian Lance Taylor 氏によって、 "windres" というリソースコンパイラが書かれました。これはウインドウリソースを、テキストの rc ファイルから COFF ファイルにコンパイルするのに使用されます。ソースは binutils サブディレクトリの中にあります。

たくさんのユーティリティがバージョンアップされました。 Beta 19には bash 2.01.1、 fileutils 3.16、gawk 3.0.3、 patch 2.5、 shellutils 1.16、 tar 1.12、textutils 1.22、texinfo 3.11 が含まれます。Cygwin32 上の bash は、数ある改良の中での特筆点として、ジョブコントロールが動作するようになりました。

sh の実行プログラムは、 Linux の Debian ディストリビューションの ash 0.2 になりました。このより小さくなったシェルを/bin/sh.exe として使うことで、 configure が大きくスピードアップします。

Bison 1.25 が追加されました。

Tcl/Tk はバージョン 8.0 にバージョンアップしました。互換性のあるバージョンの tix と itcl が追加されました。これらは全て Cygwin32 コンパチブルな configure ファイルが含まれていて、Win32 版の Tcl/Tk を UNIX 流の方法でビルドできます。

Expect 5.21.3 が含まれ、基本的には動作しています。

バイナリは Pentium ベースのシステムで速度が向上するように i686 最適化をオンにしてコンパイルされていますが、i386 以降のチップでも動作するはずです。

リンカ(ld)が強化されました。 -- dll をリンクするときに、idata3 ターミネータが自動的に追加されるようになりました。

kill はシグナルの名前の引数をサポートするようになりました。ps はプロセスの開始時間情報を表示するようになりました。

デフォルトのツールのインストールでは詳細は隠されますが、makeユーティリティのデフォルトは Win32 モードになりました。これはサブシェルとして cmd.exe/command.com を使うというモードです。このモードではファイル名にバックスラッシュが使えます。UNIX プログラムをビルドするには MAKE_MODE 環境変数を "UNIX" に設定する必要があります。こうすることでサブシェルに sh.exe を使用する従来の振る舞いになるでしょう。

Cygwin32 API (cygwin.dll) の変更:

インタフェースはより明確になりました。libc、libm と UNIX 互換関数が含まれています。libgcc.a の外部名は含まれません。これによってより安定したインタフェースになるはずです。インタフェースのドキュメントは calls.texinfo を参照してください。

dll 全体の振る舞いを制御する環境変数は、 CYGWIN32 という変数一つだけになりました:

set CYGWIN32=[no]title [no]strip_title [no]binmode [no]glob strace=mask:cache,file [no]tty

"set CYGWIN32=title tty" と設定すれば、tty のサポート(以下参照) を行い、現在の実行プロセスをタイトルバーに表示します。

B19 では以下のサポートが追加されています:

tty と仮想 tty デバイス。今のところ、tty はデフォルトではオフです。これは console を取得するのは、 Cygwin コンソール内で Cygwinではないコンソールプログラムを使用するときに問題を引き起こすからです。これをオンにするには、環境変数 CYGWIN32 に "tty" を含むように設定します。
ハードリンク(NTFS ファイルシステム上の NT が必要)。使用不能のときは(NTFS 以外のファイルシステム上では)、link() は以前のリリースで行っていたように当該ファイルのコピーを作ります。
SIGWINCH シグナル。tty 制御が有効のとき、プロセスは画面サイズが変更されたときに SIGWINCH シグナルを受け取ります。
有効な端末エスケープシーケンスの追加: <ESC>[n1;n2r によるスクロール領域の設定と、xterm のエスケープシーケンスを使ったコンソールタイトルの設定: <ESC>[2;new title^G 。

以下の関数が追加されました:

ptsname, grantpt, unlockpt
login, logout, ttyslot, ctermid
cfgetispeed, cfgetospeed, cfsetispeed, cfsetospeed
setitimer, getitimer, ftime, tzset
wait3, wait4, pause, sigpause
getpgid, killpg, setegid (stub)
strlwr, strupr
sexecve, sexecl, sexecle, sexeclp, sexeclpe, sexecv, sexecp, sexecvpe
rcmd, rresvport, rexec
strsignal, strtosigno
dlopen, dlsym, dlclose, dlerror
inet_netof, inet_makeaddr
socketpair
fpathconf, realpath, chroot (stub)
initgroups (stub), getgroups
random, srandom

以下の関数は削除されました:

ScreenCols, ScreenGetCursor, ScreenRows, ScreenSetCursor
getkey, kbhit
crypt (stub)
libgcc.a の全ての外部名

Winsock dll (wsock32.dll) はもはや Cygwin32 dll に暗黙のうちにリンクされることはなくなりました。代りに、プロセスが Cygwin32 のネットワーク関数を最初に呼び出したときに、LoadLibrary によって明示的にロードされます。これによって多くのプロセスはかなりスピードアップします(configure で約 20%)。

シグナル関連のコードは一から書き直されました。パスを扱うコードのほとんども同様です。

ファイル名展開(globbing)と getopt のコードは BSD 派生のコードに置き換えられました。正規表現のコードは Henry Spencer 氏のPublic Domain な実装に置き換えられました(訳注:原文の Harry Spencer という名前は誤植)。

Doug Lea 氏の malloc が cygwin から公開されるデフォルトの malloc として使用されるようになりました。この malloc はスピードとコンパクトさのバランスを非常にうまくとっていますが、しかしすでに free されているメモリを free しようとするのを許してくれません。すなわち、セグメンテーション違反を引き起こします。

bsearch 関数は書き直されました。

Alt Gr キーの振る舞いはこのリリースで変更されました。左 alt キーは今までどおり ESC キーシーケンスを生成します。右 alt(Alt Gr) キーは国ごとのキーボードレイアウトに従った文字が生成されるようになりました。

プロセスは、 CYGWIN32 環境変数に "title" を含めない限りタイトルバーに名前を表示しなくなりました(上記参照)。

複数の cygwin.dll は、それらが同一(同時にビルドされたもの)でない限り、同じメモリ空間を使わなくなりました。これによって互換性のない共有メモリの使い方をする複数の dll を同時に走らせることができます。これは buggy な cygwin.dll をデバッグする機能でもあります。最新の cygwin.dll をシステム上に一つだけ残すようにすれば、全ての cygwin プロセスが同じ共有メモリ空間に存在するということが保障されるでしょう。

/ のマウントのデフォルトはもはや C: ではありません。システムドライブ(OS がインストールされているところ)がデフォルトになりました。

標準のダイナミックライブラリローダ関数 dl* が利用できるようになりました。 Cygwin32 B19 は fork の後に正しくデータをコピーし、親プロセスにロードされていた DLL を自動的に再ロードするようになりました｡さらに、DLL はロードされるときに正しく初期化され、グローバルコンストラクタが呼ばれるようになりました。グローバルデストラクタは DLL が detach されるときに呼び出されます。親プロセス中で dlopen や dlsym によって得られたハンドルは、fork された子プロセスの中でもアクセス可能です。LD_LIBRARY_PATH 環境変数が dlopen 検索に使用されます。

cygwin32 で作成された .dll 内では <cygwin32/cygwin_dll.h> ファイルをインクルードして、これらの関数を使用する .dll を作成するには DECLARE_CYGWIN_DLL(dll-entry-point) 行を使用してください。

GNU-Win32 FTP サイト

一次 ftp サイトは `ftp://go.cygnus.com/pub/ftp.cygnus.com/gnu-win32' です。またいくつかのミラーもあります:

North America:
- Alberta: `ftp://ftp.reversion.ca/pub/mirrors/gnu-win32'
- California: `ftp://ftp.cygnus.com/pub/gnu-win32'
- Texas: `ftp://ftp.deninc.com/pub'
Worldwide:
- Austria: `ftp://gd.tuwien.ac.at/pub/gnu/gnu-win32'
- France: `ftp://ftp.fwntug.org/gnu', `ftp://ftp.inria.fr/INRIA/Projects/Meta2/Scilab/Windows/cygwin/'
- Greece: `ftp://ftp.ntua.gr/pub/pc/gnu-win32'
- Italy: `ftp://aaue.matrice.it/pub/gnu-win32'
- Japan: `ftp://ftp.crl.go.jp/pub/GNU/cygnus/gnu-win32'
- Slovenia: `ftp://sunsite.fri.uni-lj.si/pub/gnu-win32'
- Spain: `ftp.rediris.es/mirror/gnu-win32'
- UK: `ftp://sunsite.doc.ic.ac.uk/packages/gnu/cygnus/gnu-win32'

内容

以下のパッケージがフルリリースの中に含まれています。

Cygnus Developer's Kit (CDK): binutils, bison, byacc, dejagnu, diff, expect, flex, gas, gcc, gdb, itcl, ld, libg++, libstdc++, make, patch, tcl, tix, tk

user tools: ash, bash, diff, fileutils, findutils, gawk, grep, gzip, m4, sed, shellutils, tar, textutils, time

user tools のリリースは、ユーザのツールのみが含まれます。

これらのツールに対してソースコードが全て利用可能です。これは上記の二つの部分に別れています。ash は現時点では個別に提供されます。

バイナリリリースのインストール:

重要! $PATH 上に存在する古いバージョンの gnu-win32 ツールを全てどけておく(または削除する)のを忘れないでください｡

上記の ftp サーバの中のどれかに接続し、最新のリリースが置いてあるディレクトリに cd します。一次サーバ上では以下の場所になります:

`ftp://go.cygnus.com/pub/ftp.cygnus.com/gnu-win32/latest'.

もしあなたが開発ツールと GNU configure 機構を実行するのに必要なプログラムが欲しければ、全リリース `cdk.exe' ダウンロードしなければなりません。もしユーザツール(上記のリストに挙げられているもの)だけに関心があるのであれば、`usertools.exe' をダウンロードしてください｡

ネットワークコネクションの信頼性が低いときは、代りに小さな塊に分割されたバイナリをダウンロードしてください。分割 cdk インストーラは、 `cdk-split'サブディレクトリからファイルを取得してください。ダウンロードが終わったら、コマンドプロンプトから以下のようにして分割ファイルを結合してください。

copy /b xaa + xab + xac + ... + xai + xaj cdk.exe
del xa*.*

ユーザツールに対しても同様の手順で行えます。

インストール実行プログラムがあなたのシステムに入ってしまえば、実行するだけです。まず最初に、インストーラはこのリリースのインストールに必要な一時ファイルを展開する場所を訊いてきます。ほとんどの人はデフォルトで良いでしょう。

次にデフォルトのインストール場所 `<system-drive>:\cygnus\b19' を選ぶように聞いてきます。もし希望があれば、他の場所をご自由に選んでください。

最後に、ショートカットを追加する Program Files フォルダの名前を聞いてきます。デフォルトは `Cygwin32 Beta 19' です。このステップが完了すると、ツールのインストールを行って終了します。

この時点で、スタートメニューの中に "Cygwin32 Beta 19" (あるいはあなたがつけた名前)が見つかって選択することができるでしょう。これは全ての特別な環境変数を設定して bash シェルを立ち上げてくれます。もしあなたが WIndows 95 を使っていて、"Out of environment space"というエラーメッセージに直面してしまったら、config.sys の中の環境変数領域の量を増やす必要があります。そしてもう一度試してください。C: がシステムドライブであれば、 shell=C:\command.com /e:4096 /p という行を追加することでこの細工を行ってくれるはずです。

この後にはあと2つやるべきことが残っています。第一に、mkdir -p /tmp とタイプして、この場所に一時ディレクトリを必要とするプログラムのために、その存在を保証しておく必要があります。

第二に、もしあなたが全ディストリビューション(`cdk.exe') をインストールしたのならば、さまざまなプログラムが `/bin/sh' を見つけられるようになっている必要があります。 `mkdir -p /bin' を行って、 `sh.exe' のコピーをそこに置いてください。古いバージョンのものがあったら削除してください。 `mount' ユーティリティを使って、どのドライブが `/' としてマウントされるかを選ぶことができます。 `mount' についてのより詳しい情報は Frequently Asked Questions (FAQ) を参照してください。

これで終わりました!

もしこのツールをアンインストールしたいと思ったときには、コントロールパネルの「アプリケーションの追加と削除」("Add/Remove Programs")によってできるでしょう。

ソースコードのインストール

このリリースに対応するソースコードをダウンロードする前に、上記の最新リリースのツール(全リリースかまたはユーザツールのみのどちらか)をインストールしなければなりません。

ソースコードの住処となるディレクトリを作成し、そこに `cd' します。

上記の ftp サーバの中のどれかに接続し、最新のリリースが置いてあるディレクトリに cd します。一次サーバ上では以下になります:

`ftp://go.cygnus.com/pub/ftp.cygnus.com/gnu-win32/latest'.

ユーザツールのソースコードが必要ならば、`usertools-src' サブディレクトリに`cd' し、そこにあるファイルをダウンロードしてください。Cygnus Developer's Kit のソースが必要なら、 `cdk-src' サブディレクトリに `cd' して、そこにあるファイルをダウンロードしてください。

command.com に戻ります。ユーザツールのソースの場合:

copy /b xba + xbb + xbc + xbd + xbe + xbf + xbg usersrc.tar.gz
del xb*.*
gunzip -d usersrc.tar.gz
tar xvf usersrc.tar

コンパイラツールのソースの場合:

copy /b xca + xcb + xcc + xcd + ... + xck + xcl cdksrc.tar.gz
del xc*.*
gunzip -d cdksrc.tar.gz
tar xvf cdksrc.tar

どちらも `src' というディレクトリの中に展開します。

これで終わりでしょう…。

オンライン上での Cygnus 情報源

GNU-Win32 プロジェクトのメインの WWW ページは

http://www.cygnus.com/misc/gnu-win32/

ツール毎の情報はここで見つかります。

http://www.cygnus.com/library/

さらなるドキュメントへのリンクはメインの web ページからアクセスできます。

質問と回答集

このツールはどこから手に入るの?

この FAQ の README セクションにあるサイトのリストを参照してください。

ドキュメントはどこにあるの?

gnu-win32 のメインの WWW ページには、非常にたくさんのリンクがあります: `http://www.cygnus.com/misc/gnu-win32/' 最低限 Release Notes とメインの WWW ページは目を通しておきましょう。何か書いてあるかも知れません。

ツールのみに関する情報はここにあります: `http://www.cygnus.com/library/'

gnu-win32 メーリングリストにはどうすれば参加できますか?

gnu-win23 メーリングリストに参加するには以下にメールを送ってください。

gnu-win32-request@cygnus.com

メッセージの本文は以下のように書いてください。

        subscribe gnu-win32  <your-email-address-here>

ここで <your-email-address-here> はあなたのメールアドレスです。

メーリングリストを脱会するには以下にメールを送ります。

gnu-win32-request@cygnus.com

脱会する時はメッセージの本文は以下のように書いてください。

        unsubscribe gnu-win32 <your-email-address-here>

mail はメーリングリストに配送されるまでに時折一、二日かかるときがあるので、脱会の要求が行われてからあなたへのメールの受信が止まるまで、一、二日のタイムラグが生じることがよくあるのを心に留めておいてください。

メーリングリストの過去のアーカイブは以下にあります。

`http://www.cygnus.com/ml/gnu-win32'

助けて! /tmp を作らないとツールが変な動作をするんです!

多くの Unix のツール(bash、byacc など)は /tmp が常に存在するものと思っています。これは Win32 の国では保証されていません。この問題を避けるには、/tmp を作るか、適当なディレクトリを選んで、/tmp にマウントしてください。

bash が "49054596: No such file or directory" などと文句を言ってくるのですけど?

ちゃんと /tmp を作りました? beta 18 以降では bash は /tmp が見つからないときは警告を出します。

"WinMain@16" が未定義といわれるのはなぜ?

ソースの中に空の main() 関数を追加して試してみてください。

私のマウントポイントはどこいっちゃったの?

以前のリリースでは、マウントポイントはレジストリの "Cygnus Support" 以下に格納されていました。これは beta 18 から "Cygnus Solutions" に変更されました。レジストリエディタ(NT では regedit)を使って古いエントリの名前を変更するか、あるいは単にもう一度マウントを行ってください。 cygwin.dll は自動的に新しい名前で作成します。

"mount failed: Device or resource busy" ってどういう意味?

これは普通、すでにマウントされている場所にさらにマウントしようとしているという意味です。例えば、c: が '/' にマウントされているとして、d: を同じようにマウントしようとするとこのエラーメッセージが出ます。まず古いものを "umount" して、それから新しいものを "mount" すればシアワセになれるでしょう。

ツールのインストールが失敗するんですが、どうして?

もし "The decompression of %s failed. There may no be enough free disk space in the TEMP directory." というエラーメッセージが出ている場合は以下を読み進んでください。

InstallShield には、TEMP ディレクトリにある数以上のファイルが存在すると失敗する、というバグがあります。もし TEMP ディレクトリに、 InstallShield が作ろうとしているファイルと同じ名前のファイル(おそらく過去の別の InstallShield インストール作業でのファイル)が存在して、何らかの理由で上書きできなかった場合にもこのエラーが出ます。これは InstallShield の将来のリリースでは修正されるかも知れません。

それまでは、TEMP ディレクトリを全部空にしてしまうのが良いです。これでファイル名の衝突がなくなりますし、"too many files" の問題も同様に解決します。

どうして man、 less、 groff などは beta に含まれていないの?

明らかな理由として、私たちは全てのツールを Cygwin32 ツールとして動作するように移植し、バイナリ配布を提供し保守を行うことは実行不可能です。その代りに、Cygnus はその労力を、核となる開発ツールに集中するべきであると考えています。たぶん V や wxwin も含めるべきかな? less や man コマンドは、満足できる程度に動くものができれば、それも含めるようになるでしょう。

他の移植されたツールは、正式なリリースに追加修正されているはずなので、そのツール用のソースから素直にコンパイルできます。もしそれが不可能な場合は、他の誰か(理由によってはもしかしたら Cygnus)が diff を保守し、ftp できるところに置くでしょう。おそらくそのようなツールはgnu-win32 の Web サイト上でリストを作ることができるでしょう…。

which はどこにあるの?

which コマンドは含まれていないのですが、ほとんど同様のことを行う bash のビルトインコマンド "type" を使うことができます。

bash から vfork できない、と言われます(あるいは単にハングする)。どうして?

ほとんどの場合、これは自分自身がパスに含まれていないからです。bashを実行する前に、bash が置いてあるディレクトリがあなたのパスに含まれているかどうか確認してください。また、bash のコピーを /bin/sh.exe としてインストールすることも忘れないでください。

シェルスクリプトを実行しようとして、それが間違いなく存在しているにも関わらず `no such file or directory' のようなエラーが出た場合には、おそらくbash が /bin/sh を見つけらないのが問題なのです。

find が根本的に問題があるんですけど、なんで?

find が gnu-win32 ツールに付属しているものを使っていること、つまり間違って Win32 の find コマンドを拾ってしまっていないことを確認してください。正しいものを使っていることの確認は、bash から "type find" することで確かめられます。

これらはみんな、どんな風に動いてるの?

Unix スタイルの API を提供する C のライブラリがあります。アプリケーションはそれとリンクされて…、ほら、Windows 上で動きました。

目標は、あなたのアプリケーションを Windows で動かすために必要な全ての行儀の悪いやつを、C ライブラリに追加することです。そうすればあなたのアプリケーションは、ソースレベルでの変更無しに、Unix と Windows で動くでしょう。

この C ライブラリは DLL 内にあり、基本的なアプリケーションはとても小さくなります。またこれにより、DLL の変更時にバックワードコンパチビリティを残すことで、Win32/Unix 翻訳層のアップグレートを容易にアップグレードできます。

Win32 API 呼び出しはどうやって使うの?

実はとっても簡単です。GNU-Win32 の要求は、あなたが使おうとしている Win32 API 関数のインポートライブラリを明示的にリンクすることだけです。例外は kernel32 で、これは自動的にリンクされます(これはスタートアップやビルトインのコードがそれを使うからです)。

例えば、グラフィック関数(GDI)を使うには gdi32 をこのようにリンクしなければなりません:

gcc -o foo.exe foo.o bar.o -lgdi32

あるいは(コンパイルとリンクを同時に行う):

gcc -o foo.exe foo.c bar.c -lgdi32

以下のライブラリがこの方法で利用可能です。

advapi32 largeint ole32 scrnsave vfw32 cap lz32 oleaut32 shell32 win32spl comctl32 mapi32 oledlg snmp winmm comdlg32 mfcuia32 olepro32 svrapi winserve ctl3d32 mgmtapi opengl32 tapi32 winspool dlcapi mpr penwin32 th32 winstrm gdi32 msacm32 pkpd32 thunk32 wow32 glaux nddeapi rasapi32 url wsock32 glu32 netapi32 rpcdce4 user32 wst icmp odbc32 rpcndr uuid imm32 odbccp32 rpcns4 vdmdbg kernel32 oldnames rpcrt4 version

通常のセットアップでは、 -mwindows オプションをコマンドラインに使うことで、user32、gdi32、IIRC、comdlg32 などを含む基本的なライブラリ群を含めることができます(そしてプログラムを console プログラムではなく、GUI プログラムにする)。

ただし、ld を直接起動しているのでない限り、-lkernel32 をリンク行に含めてはいけないことに注意してください。リンク行に同じインポートライブラリを2度含めてはいけません。最後に、インポートライブラリをリンク行の最後か、少なくともそれを参照する全てのオブジェクトファイル、スタティックライブラリの後ろに置くのが良い方法です。

最初の2つは、インポートライブラリが2回参照されるときのリンカが持つ問題に関連しています(少なくとも b18 以降)。テーブルがぐちゃぐちゃになって、プログラムが無作為にクラッシュしてしまいます。最後の点は、gcc がコマンドライン上のファイルのリストを順番に処理し、ライブラリを参照しているファイルの後ろにあるライブラリに対してのみ参照の解決を行うという事実に関係があります。

コンソールウィンドウを無くしてしまうには?

コンパイル時のデフォルトは、コンソールアプリケーションを生成するようになっています。GUI プログラムを書いているのであれば、上記で説明したように -mwindows オプションをつけてコンパイルするか、 "-Wl,--subsystem,windows" を GCC のコマンドラインに追加するかしてください。

Cygwin32 ライブラリはスレッドセーフですか?

残念ですが「いいえ」です。私たちも最終的にはスレッドセーフにしたいのですが、それは大変な作業になるでしょう。ミニマリストパッケージ(mingw32)はマルチスレッドセーフのようです。これはプロジェクトのメインのウェブサイトから手に入れられます

どうして Microsoft の Win32 ヘッダを再配布しないのですか?

`Microsoft Open Tools License agreement' のセクション 2.d.f には、「エンドユーザに対して再配布可能の形でさらに再配布することは認められない」、とあるようです。私たちはこれを、私たちがあなたにあげることはできるけれども、それをあなたが他の誰かにあげることはできない、という意味だと取りました。これは Cygnus としては賛成できないことです。ですが幸運にも、私たちはほぼ完璧な、独自の Win32 ヘッダを持っています。

.lib ファイルはどうやってリンクするのですか?

C ファイルに関数テーブルを入れて作成する。このテーブルには使いたい関数を全部入れます。これはリンカに .lib のオブジェクトファイルを含めさせるようにするためです。おそらく LINK.EXE にはオブジェクトファイルを含めさせるオプションはあるんでしょうが。
ダミーの 'LibMail' を作成する。
必要なエクスポート名を全て入れた .def ファイルを作成する。
link.exe を使って .lib をリンクする。

あるいは

LIB.EXE を使って .lib からから全てのオブジェクトファイルを取り出す。
必要な関数を全て参照するダミーの C ファイルを作成する。直接呼び出すものも初期化された関数ポインタも両方ともです。
ダミーの LibMain を作成する。
全てのオブジェクトと上記のファイル、LibMain をリンクする。
.def ファイルを書く。
リンクする。

この方法で、MSVC(とその他多くのランタイムライブラリ)を gnu-win32 開発ツールで使うことができます。

これは大変な作業(丸半日とか)ですが、それでも問題のランタイムライブラリを仕様から書き直すよりはまだましでしょう…。

(Jacob Navia (root@jacob.remcomp.fr) 氏から説明をいただきました。ありがとうございます)

NT でサポートされていて 95 でサポートされてないものがあるのはなぜですか?

Windows 95: n. 32 bit extensions and a graphical shell for a 16 bit patch to an 8 bit operating system originally coded for a 4 bit microprocessor, written by a 2 bit company that can't stand 1 bit of competition.

(訳注: 参考までに拙訳を以下に載せますが、やっぱり原文の方が面白いですよね)

Windows 95: 名詞。 1ビットたりとも競争力のない2ビット程度の会社が作った、4ビットマイクロプロセッサ用コードがもとになっている8ビットオペレーティングシステムに対する16ビットパッチのための32ビット拡張グラフィックシェル。

でも真面目に、Windows 95 にはほとんどのセキュリティ関連の関数は無く、他にもいくつか Win32 API の一バージョンとして足りないものがあります。Win 95 において何がサポートされてないかについての情報は、calls.texinfo を参照してください。

B19 における既知の問題、潜在的な問題

GUI 版の gdb が Windows 95 ではクラッシュしてしまうんですが、どうして?

まだわかってません。-nw オプション付きで起動するか、NT をインストールしてやり直すか、今後のリリースでこの問題が修正されるまで待ってください。

DLL 内における固定長配列

DLL内には依然、動的な構造体でなく固定長配列が使用されている個所が多数残っています。動的な構造体の使用は我々に必要以上のお金を使わせるし、 Cygwin32 層の能力を制限してしまいます。

引数における // 形式のパス名を扱えないプログラム

gcc や他のツールは、現在のパス名の形式に完全には適合していません。自分自身をホストにしようとしたときに絶対必要となる -I//d/foo という引数は通用しません。このときは、一つだけのスラッシュによる通常のパスのみが使われます。

DOS 特殊ファイル名

ファイル名に com1、lpt1、aux は、ファイル名の基幹部分としても、拡張子部分としても使えません。もし使ってしまうと面倒が起きるでしょう。Unixプログラムはこれらの名前を避けるような楽しいことはしてくれません。例えば、 perl のディストリビューションの中には aux.sh というファイルがあります。perl のコンフィグレーションでは aux.sh ファイルが存在することを確認しようとしますが、`aux' という魔法の文字が含まれているファイルを操作しようとしてハングしてしまうでしょう。

ユーザ定義 malloc

もしあなたのプログラム中で malloc という名前の関数を定義していて、DLL(cygwin32.dll) とリンクした場合、 DLL はあなたの malloc を呼び出します。あなたの malloc がきちんと動くか確認した方が良いです。

プログラムを bash からではなく DOS コマンドプロンプトから実行した場合、 DLL はコマンドラインのワイルドカードを展開しようとします。この処理はあなたの main 関数の処理を開始する前に malloc を呼び出します。もしあなたのmalloc が、main が呼び出された後に起こる初期化を必要とするようにかかれている場合、間違いなくおかしくなるでしょう。

大文字/小文字が混在したファイル名

perl の config はまた別の問題を引き起こします。config<foo>.SH スクリプトは "Makefile" という名前のファイルを生成しますが、その途中で "makefile" という名前のファイルを使用、削除します。NT では大文字/小文字の違いは無視されるため、Makefile が攻撃を受けてしまい、後には何も残りません。

/etc はどうやって設定するの?

/etc を正しく設定するには(そうすると例えば "ls -l" がユーザ情報を正しく表示するようになる)、もしあなたが NT を使っているのなら(NTFS ファイルシステムの方が良い)、単に / としてマウントされているファイルシステムに/etc ディレクトリを作り、そして mkpasswd と mkgroup を使って、 /etc/passwd と /etc/group をそれぞれ作成してください。Windows 95 の Win32 API は不完全なので、もしあなたが Windows 95 を使っているのなら残念でした。

私の NT でツールを再構築するにはどうするのでしょう?

ソースが /src にあり、/obj ディレクトリでビルドし、/install にツールをインストールしたい、仮定します。

bash
cd /obj
/src/configure --prefix=/install -v > configure.log 2>&1
make > make.log 2>&1
make install > install.log 2>&1

Unix と NT でファイルを共有したいのですが?

開発中は、私たちは Samba の動いている Unix マシンと NT/Windows 95 デュアルブートマシンの両方を使っています。私たちはよく Unix 上のクロスコンパイラを使ってビルドしてバイナリとソースを NT/Win 95 システムにコピーしたり、あるいは単に Samba でマウントされたパーティション上で直接いじくりまわしたりしています。これらのツールは NTFS 上でもちゃんと動くはずですが、通常私たちは、 Windows 95 上からもアクセスできるように FATファイルシステムを使用しています。

PowerPC 版 NT 用のツール群はどうやってコンパイルできますか?

残念ながら、これは難しいです。Microsoft が PowerPC 版 NT の開発を止めてしまって以来(1996 後半)ずっとビルドされていません。例外処理やシグナルサポートのセマンティックス、引数が x86 版では修正されていて、PPC 用には更新されていません。したがって PPC 特有のサポートを書き直す必要があるでしょう。他にどんな非互換性があるかわかっていません。もしこれを修正してくださるなら、ぜひ私たちにパッチを送ってください!

Alpha 版 NT 用のツール群はどうやってコンパイルできますか?

Alpha 版 NT 用には移植されておらず、現時点では移植する予定もありません。どなたか Alpha 版 NT をサポートする修正を寄附していただけると嬉しいです。

アプリケーションのヒープ・スタックサイズはどうやって調整できますか?

gcc にヒープ・スタックサイズのリンクオプションを渡してください。 foo.exe をヒープサイズ 1024、スタックサイズ 4096 で作成するには、 gcc をこのように起動してください:

gcc -Wl,--heap,1024,--stack,4096 -o foo foo.c

"Out of Queue slots" っていうメッセージが出ちゃうんですが、どうして?

"Out of queue slots!" は通常、削除する権限のないファイル(パーミッションがない、排他的に使用中である、など)をたくさん消そうとしたときに出ます。何が起こるかというと、gnuwin32 はこれらのファイルを後で削除できるようになるだろうという仮定のもとに待ち行列に入れてしまうのです。そのファイルのパーミッションが後で変更されたとすると、そのファイルは要求通りに削除されるでしょう。しかし、アクセスできないファイルを削除する要求があまりにたくさん来るとキューが溢れてしまって、ご質問のメッセージが出てしまうのです。普通はすぐに chmod する、ファイルを閉じる、などによって対処することができます。(Larry Hall 氏に説明をいただきました。ありがとうございます)

実行プログラムが何の dll を必要としているか、どうすれば分かりますか?

objdump -p がこの情報を提供してくれます。

Cygwin32 の fork() はどう実装されてるの?

Cygwin32 の fork() は、本質的には `non-copy on write' 方式(古い Unix のバージョンで取られていた方式)の fork() のように動作します。このため、多少遅いです。多くの場合においては、できる限り spawn の類の呼び出しは使わない方が良いです。

fork は beta 18 ではこのように動作します。

親は、子のための Cygwin プロセステーブルの領域を初期化します。親は Win32 の CreateProcess に自分が起動されたときと同じパスを与えて、中断した子を生成します。親は setjmp を呼び出してコンテキストを保存し、このポインタを Cygwin32 の共有メモリ領域にセットします(この領域は全ての Cygwin32タスク間で共有されてます)。親は、子の .data と .bss セクションを、自分のアドレス空間から中断した子のアドレス空間へとコピーして埋めます。そして親はその子を開始させます。親は mutex によって、子が安全な地点に来るまで待ちます。子は開始して fork されたのがわかったら、保存されたジャンプバッファを使って longjump します。子は親の待っている mutexをセットし、そして親がスタックとヒープを埋めてくれるまで、別の mutex 上でブロックします。親は子が安全な領域に入ったことを知って、スタックとヒープを自分のものから子の中へコピーし、子が待っている mutex を解放して、 fork 呼び出しからリターンします。子はブロックしている mutex から起きて、共有領域を通して渡された mmap 領域を再作成し、fork 自身からリターンします。

ワイルドカード(ファイル名展開)はどう動くの?

CYGWIN.DLL を使うアプリケーションが起動して、その時 PID 環境変数が見つからない場合は、これは DOS スタイルのコマンドプロンプトから起動されたものとみなします。これはまず間違いはありません。というのも、他のツール(bash も含めて)は起動時に新しいプロセスの PID がいくつであるかを知るために PID を設定するからです。

DLL が、これは DOS スタイルのプロンプトから来たと思ったときは、与えられたコマンドラインに対してファイル名の展開を実行します。これはつまり、 DOS から LS *.EXE とタイプした場合、あなたが期待しているであろう動作を行う、ということです。

注意: ファイル名展開はmallocを使用します。もしあなたのアプリケーションが malloc を定義しているのなら、それが使用されます。これはあなたにとってとんでもないことかもしれません(訳注: ユーザ定義 malloc 参照のこと)。

他のドライブはどうやってアクセスするの?

beta 16 以降では、任意のドライブ文字をパスに含めて参照することができます。ドライブ a: に対して ls を実行するには、以下のようにします。

bash$ ls //a/

あるいは、"mount" コマンドを使って一つのスラッシュだけで参照することもできます。

bash$ mount a:/ /mnt/floppy
bash$ ls /mnt/floppy
....

raw デバイスに書き込みたい場合には、A ドライブには /dev/fd0 、B ドライブには /dev/fd1 を使います。

例

bash$ tar cf /dev/fd0 *.exe
bash$ tar tvf /dev/fd0
....

また、UNC パスに対しても標準的な方法でアクセスできることも覚えておいてください。上記で述べたドライブ文字のショートカットのために、UNC パスのマシン名は、一文字よりも長くなくてはなりません。

他のディスクにはどうやって到達できるの?

`mount' コマンドを使ってマウントすることができます。例えば、

$ mount i:/a /a
$ mount 
i:\a on /a type dos (normal)
c:\ on / type dos (normal)

これはファイルがオープンされるときに文字列の置き換えによって行われます。従って、上記のようにマウントされている上で ls /a/barを行うと、内部の仕掛けが ls i:/a/bar に変換します。

ドライブをマウントするのはただ一度だけでよいことを覚えておいてください。この対応づけはレジストリ内に保存されるので、マウントはずっと永遠に有効になります。マウントを取り除くには umunt コマンドを使います(あるいはレジストリエディタか)。

`-b' オプションはバイナリモードでマウントします。

もしこのリリースを `C' ドライブ以外のドライブに置きたい場合には、先に進むためには mount コマンドを使用しなければいけません 。

例えば、f:/fish 以下にツリーをインストールしたとします。すなわち、バイナリの行き場所はf:/fish/bin 以下、などになります。

$ mount f:/fish /usr

この意味は、 ls /usr/bin を実行すると、CYGWIN.DLL は f:/fish/bin を見に行く、ということです。

GNU-Win32 ではファイル名の大文字、小文字の混在が可能なのですか?

いくつかの Unix プログラムでは、同じ綴りのファイル名を大文字、小文字を違えて使い分けられることができると期待しています。重大な例として perl のコンフィグレーションスクリプトがあり、これは Makefile と makefile を必要とします。WIN32 はただ大文字、小文字だけが違うこれらのファイルを区別できず、コンフィグレーションは失敗します。

beta 16 以前のリリースでは、mount にはファイル名を変更して大文字、小文字ファイル名を使い分けられる、特別な mixed case オプションがありました。私たちはこのサポートを、beta16 のパス操作コードを書き直すときに、削除することに決めました。

DLL はどうやって作るの?

gnu-win32 プロジェクトの web ページ (http://www.cygnus.com/misc/gnu-win32)上に、この手順を説明した文書があります。

MainCRTStartup にブレークポイントを設定するにはどうすればいいですか?

gdb で *0x401000 にブレークポイントを設定して、当該プログラムを実行してください。

暴走しちゃったら、どうすれば戻れるの?

ときたま、これらのツールは単に止まってしまいます(aux.sh というファイルを読んでみると簡単に止められます)。元の世界に戻るには、^C を押して bash か cmd プロンプトに戻ってください。

もし別のシェルを起動していて、それでアプリケーションが動かなかったのなら、暴走したプロセスがまだどこかで動いてると思った方がいいです。

pview があるのなら、それを起動して kill してください(aux 関係であれば、アプリケーションは cp という名前になっているかも知れません)。pview かそれと同様なものがなければ、おそらくログアウトしなければならないでしょう。

DOS/Unix の CR/LF 問題はどう処理されているの?

デフォルトでは、バイナリを扱うツール(objdump など)は、unix 風のバイナリモードで操作し、テキストファイルを扱うツール(bash など)はテキストモードで操作します。

テキストファイルモードにおける DOS の CR/LF 改行は、レジストリの fmode-binary を 0 に設定することで有効にできます。私はファイルタイプは「自然」のままにしようとしてきました。デフォルトではファイルはテキストモードでオープンされますが、これは open 呼び出しの２つめの引数に O_BINARY を付け加えるか、 fopen呼び出しの2つめの引数に"b" を付け加えることによって変更できます。また、setmode (fd, O_BINARY) も使うことができます。

lseek は現在はバイナリモードでのみ動作します。

リロケータブルな dll はどうすれば作れるの?

以下に示す 5つのコマンドをこの順序で実行しなければなりません:

$(LD) -s --base-file BASEFILE --dll -o DLLNAME OBJS LIBS -e ENTRY

$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE \
        --base-file BASEFILE --output-exp EXPFILE

$(LD) -s --base-file BASEFILE EXPFILE -dll -o DLLNAME OBJS LIBS -e ENTRY

$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE \
	--base-file BASEFILE --output-exp EXPFILE

$(LD) EXPFILE --dll -o DLLNAME OBJS LIBS -e ENTRY

この例では $(LD) がリンカ ld です。

$(DLLTOOL) は dlltool です。

$(AS) はアセンブラ as です。

DLLNAME はあなたが作ろうとしている DLL の名前、例えばtcl80.dll など。

OBJS は DLL に入れようとしているオブジェクトファイルのリストです。

LIBS はその DLL にリンクしたいライブラリのリストです。例えば -lcygwin は要るかもしれないし要らないかもしれません。-lkernel32 は要るでしょう。Tcl は -lcygwin -ladvapi32 -luser32 -lgdi32 -lcomdlg32 -lkernel32 をリンクします。

DEFFILE はあなたの定義ファイルです。単純な DEFFILE は"EXPORTS" とそれに続いて DLL から公開する全てのシンボル名のリストからなります。各シンボルは一つで一行でなくてはなりません。他のプログラムは、ここでリストされたシンボルにのみアクセスできるようになります。

BASEFILE はこの5段階の処理中に使われる一時ファイルです。例えば tcl.bash など。

EXPFILE はまた別の一時ファイルです。例えば tcl.exp など。

ENTRY はエントリポイントとして使用する関数の名前です。この関数は WINAPI 属性付きで 3つの引数を取らなくてはなりません:
int WINAPI startup (HINSTANCE, DWORD, LPVOID)

実際のシンボル名は @12 が付加されるので、本当のエントリポイントの名前が `startup' であれば、ENTRY に指定する文字列はこの例では `startup@12' ということになります。

もしあなたの DLL が cygwin32 の関数を呼び出すのであれば、エントリ関数は cygwin32「不純」ポインタを初期化する必要があります。これはグローバル変数 `_impure_ptr' を宣言して、エントリ関数の中で初期化することによって行います。このグローバル変数 `_impure_ptr' は DLL から公開しないように注意してください。つまり DELFILE には入れないでください。

/* This is a global variable.  */
struct _reent *_impure_ptr;
extern struct _reent *__imp_reent_data;

int entry (HINSTANT hinst, DWORD reason, LPVOID reserved)
{
  _impure_ptr = __imp_reent_data;
  /* Whatever else you want to do.  */
}

$(LD) 行に `--subsystem windows' オプションを付け加えてもよいです。Tcl のビルドではそうしていますが、私はこれが重要だったかどうかはもはや覚えていない、というのを白状しておきます。

$(LD) 行に `--image-base BASEADDR' オプションを付けてもよいです。これはデフォルトのイメージベースを設定します。この DLL を使用するプログラムは、それぞれの DLL がアドレス空間の別々の場所を占有すると、起動がちょっとだけ早くなります。それぞれの DLL はこのイメージベースから始まって必要なサイズだけ連続して占有します。

さて、これであなたの DLL ができたので、他のプログラムからリンクできるようにライブラリを作りたくなるでしょう。これは必須ではありません: LoadLibrary によって常にその DLL を使うことができるからです。ですが、DLLを直接リンクできるようにしたければ、ライブラリを作成する必要があります。このようにしてください:

$(DLLTOOL) --as=$(AS) --dllname DLLNAME --def DEFFILE --output-lib LIBFILE

$(DLLTOOL)、 $(AS)、 DLLNAME、DEFFILE は上記と同じです。DLLNAME と DEFFILE は必ず同じ物を使ってください。さもないとちゃんと動きません。

LIBFILE は作ろうとするライブラリの名前です。例えば libtcl80.a など。これでリンカコマンドに -ltcl80 などのように使うことによってこのライブラリをリンクできます。

何が起こってるかをデバッグするにはどうすればいいの?

gdbを使ってあなたのアプリケーションをデバッグすることができます。 -g フラグをつけてコンパイルするのを忘れないでね! そのアプリケーションが MS の dll にある関数を呼び出しているのであれば、gdb はプログラムを実行したときに、それらのデバッグ情報をロードできないと文句を言ってくるでしょう。これは正常です。というのはこれらの DLL はデバッグ情報を持っていないからです(たとえ持っていたとしても、そのデバッグ情報は gdb 互換性が無いでしょう)。

代りにシステムトレースメカニズムを使えますか?

はい。最も基本的なレベルでは、STRACE環境変数を 1 に設定すると、Cygwin32 アプリケーションを実行するといつでも、デバッグ情報が全部画面に表示されるでしょう。これはバグを Cygwin32 ライブラリの中まで追っかけていくときには特に有効に使えるツールです。STRACE は他の値に設定して、詳細の度合いを変えることもできます。2つほど挙げると、0x10 に設定するとシステムコールに関する情報、また 0x800 とするとシグナル、プロセス制御関連情報が得られます。strace メカニズムは Cygwin32 ライブラリのソースの中の winsup/include/sys/strace.h ファイルでよく説明されています。

シンボリックリンクはどう動いてるの?

CYGWIN.DLL はマジックヘッダを持つリンクファイルを生成します。どこかにリンクされているファイルまたはディレクトリをオープンすると、そのマジックヘッダに書かれてあるファイルまたはディレクトリをオープンします。

リンカが、何かを見つけられない、と文句を言います。

ありがちなエラーとして、コマンドライン上のライブラリを、それが必要とされるものより前に置いてしまうというものがあります。

これは間違い。 gcc -lstdc++ hello.cc
これは正しい。 gcc hello.cc -lstdc++

API の中にある関数を使っているのに、リンクエラーが出ます。

その関数は恐らくヘッダファイルで宣言されていないか、UNICODE 用のものが入っていないかでしょう。

libc をリンクしている dll を作れますか?

はい。

なぜ、実行ファイルでもないのに `x' 属性を持つファイルがあるの?

ファイルに対して unix スタイルの属性ビットを操作するときは、ライブラリは WIN32 API で提供されていないいくつかの情報を埋めなくてはなりません。

これはファイル名が .exe か .bat であれば実行可能と判断しますし、またファイルの先頭に "#!" の文字を持つものも同様です。

どうしてあなたは/メーリングリストでは私の質問に答えてくれないの?

それはおそらく、あなたの質問はすでに FAQ の中にあるからです。また、おそらく誰もあなたの質問に答える時間がないのでしょう。あるいは、誰も答えを知らないのかも…。

ネットワーク関連の関数はどう働くの？

cygwin32 におけるネットワークサポートは Unix API の提供を想定しており、 winsock API ではありません。

API 上では同じ名前の関数でも、意味の違う関数が存在します。

例えば、Unix の select システムコールは標準ファイルハンドルとソケットのハンドルに対して待つことができますが、winsock の select コールはソケットのみです。このため、cygwin.dll はさまざまな winsock/win32 関数に、無理矢理 Unix select と同じようなことをさせるために、裏でかなり汚いことをやっています。

もしすでに winsock を使っているアプリケーションを移植しようとしているのであれば、 cygwin32 のネットワークサポートを使用するには間違っています。

しかしそれでもネイティブの winsock も cygwin32 も使うことはできます。 cygwin.dll が export している関数は 'cygwin32_<name>' という名前です。たくさんのマクロ定義が、標準の Unix 名から DLL で export されている名前への関連付けを行っているのです。 include/netdb.h を覗いてみてください。

..etc..
void		cygwin32_setprotoent (int);
void		cygwin32_setservent (int);
void		cygwin32_setrpcent (int);
..etc..
#ifndef __INSIDE_CYGWIN_NET__
#define endprotoent cygwin32_endprotoent 
#define endservent cygwin32_endservent 
#define endrpcent  cygwin32_endrpcent  
..etc..

これは標準 Unix ヘッダファイルを include すると Unix->cygwin32 のマッピングが行われる、というアイデアです。これを使った場合、 libwinsock.a をリンクする必要はありません。ネットワークに必要な全てのものは DLL 内にあります。

mywinsock.h ファイルは、標準 winsock.h をハックしたもので、標準 Unix API と衝突するビット値や他のヘッダで定義されていたりするものを削除したものです。例えば、mywinsock.h においては struct hostent の定義は削除されています。これは Unix マシンでは netdb の中にあるものだからです。これをあなたのアプリケーションで使うのは良いことではありません。

b19 リリースでは、この情報はちょっと古くなっています。

Unix ソケットは要らないんだけど、どうすれば普通の Win32 の winsock を使えるの?

そのままの Win32 の winsock を使うには、ソースファイルの先頭で #define Win32_Winsock と #include "windows.h" とするのが必要なだけです。あと libwsock32.a とリンクするために、コンパイラのコマンドラインに -lwsock32 を付け加える必要があるでしょう。

なんでこんな変なディレクトリ構造なの?

どうして cpp.exe、cc1.exe などは bin ディレクトリにはないの?

どうして lib や include ディレクトリが一つじゃないの?

H-i386-cygwin32\lib\gcc-lib\...\cygnus-2.7.2-960712\include
x86-cygwin32\include
x86-cygwin32\H-i386-cygwin32\i386-cygwin32\include

この方法では、違ったホスト、ターゲット間での複数のリリースが、同じツリーの中で共存できます。 H-i386-cygwin32 は、i386-cygwin32 によってホストされるという意味で、全てのホストで共有される共通ファイルはトップレベルのディレクトリにあり、ターゲット毎のファイルは H-i386-cygwin32/i386-cygwin32 以下にある、といった具合です。

もし ppc NT マシンと x86 NT マシンとでファイルを共有するサーバがあったとすれば、H-i386-cygwin32 と H-powerpcle-cygwin32 の両方のディレクトリを持ち、トップレベルにある共通のファイルはそれぞれのマシン毎に重複して持つことはありません。もし i386-cygwin32 と m68k-coff 間のクロスコンパイラでビルド、インストールした場合には(それが今あるのかどうかは良く分からないけど、まあ、単なる例として)、H-i386-cygwin32/m68k-aout というターゲット依存ファイルの入ったディレクトリができて、m68k-aout- のプレフィックスがついたバイナリがいくつか H-i386-cygwin32/bin にできるでしょう。

通常、リリースを識別するためにさらに上のレベルのディレクトリを作ります。もし複数の gnuwin32 リリースが別々の DLL バージョンとして共存する場合には、以下のようなディレクトリができるでしょう。

gnuwin32/b16/H-i386-cygwin32
gnuwin32/b17/H-i386-cygwin32
...

どちらにしろ、これはディレクトリ構造をさらに複雑にさせますが、さらに複雑なインストールを行う人々のためには価値があることです。

msvc++ と gcc でコンパイルされたオブジェクトを混ぜられますか?

はい、おそらく動きます。キーポイントはリンクするのに、 GNU ld ではなく MS の LINK.EXE を使うことのようです。C++/Obj C のコンストラクタに関する問題があるようです。

VC++ でビルドされたプログラムを gdb を使ってデバッグできますか?

いいえ、完全な(ソースコードでのハイレベルな)デバッグはできません。 Microsoft のコンパイラは、gdb が理解できない違ったタイプのデバッグ用シンボル情報を生成します。

しかし、ローレベル(アセンブラ型)のシンボルは Microsoft コンパイラが生成するのは coff であり、これは gdb は理解「できます」。したがって、少なくとも全てのグローバルシンボルは見ることができるはずです。データ型、行番号、ローカル変数などの情報は得られません。

Cygwin32 はマルチユーザ環境ではどれくらい安全なのですか?

Cygwin32 はマルチユーザ環境では安全ではありません。例えば普通のユーザがログインするような環境で、"inetd" のようなデーモンを管理者権限でずっと走らせたり、あるいは誰かがコンソールからログインしている間他のユーザがリモートでログインしたりすると、ある cygwin クライアントは他のクライアントをだましてコードを実行させることができます。この方法であるユーザは、そのマシンで動作している他の cygwin プログラムの権限を得ることができてしまいます。これは cygwin は全てのプロセスからアクセス可能な共有状態を持つからです。

Tim Newsham (newsham@lava.net) 氏から説明をいただきました。ありがとうございます)

x86 アセンブラの情報はどこかにありますか?

Intel の現在のチップの CPU リファレンスマニュアルは、Intel のウェブサイトから PDF 形式でダウンロードできます。

`http://developer.intel.com/design/pro/MANUALS/242691.HTM'

Cygwin32 にはどんなバージョン番号がつけられているんですか?

cygwin.dll には新しい gnu-win32 のベータリリースが作成される度に大きくなるメジャーバージョン番号があります。これはリリースの名前に対応しています(例えば、beta 19 のメジャー番号は "19" です)。

また、cygwin.dll にはマイナーバージョン番号もあります。もしすでに出されているリリースに対して、ライブラリが更新されてリリースされた場合、マイナー番号が増えます。

"uname- v" で、cybwin.dll のバージョン番号を "メジャー.マイナー" のように表示します。

最後に、Cygwin32 がレジストリの使い方に互換性のない変更が行われたときのみに変更されるレジストリバージョン番号があります。これは beta 16 以降 "B15.0" です。

シェルスクリプトが Makefile の中からちゃんと動かないんですけど?

$PATH の中に . (ドット)が必要です。Makefile から起動される全てのシェルスクリプトの前にいちいち /bin/sh を付け加える必要はありません。

アンチウイルスプログラムは gnu-win32 を気に入ってくれるのかな?

ある方の報告では、 NT 用(他のも?)の McAfee VirusScan は gnu-win32 とは相容れない、とのことです。これは cygwin.dll の中で新しくロードされた共有メモリをスキャンしようとするためで、そのおかげで fork() が失敗し、多くのツールをめちゃくちゃにしてしまいます。

GNU-WIN32 と CYGWIN32 はちゃんと考えられた上での名前なのですか?

私たちはソースの中では GNU-WIN32 は少しずつ除去していこうとしています。これは2つのもっともな理由によるものです - a) 全てが GNU のコードではない。b) WIN32 API を提供しているものではない。

私たちはとりあえず、コンフィグレーションの合言葉として cygwin32 を使っていますが、もっと良い名前があれば変更されるでしょう。

この名前の構成にはちょっとばかり理屈があります。これらのツール一式全部を `gnu-win32' と呼び、これらが動作するライブラリ、API を Cygwin32 API と呼びます。ある日、誰かがさらにコードを書くかも知れません - 例えば 'bsd-win32' とか。それでもこれは Cygwin32 API の上で動作する、というわけです。

どうして beta 16 でプリプロセッサのマクロ定義が変わっちゃったの?

このリリースの前は、これらがとても混乱していて、とても「良く」定義されていました。今は、Win32 API にアクセスするためには _WIN32 、DLL によって提供される cygwin32 環境にアクセスするためには __CYGWIN32__ があります。

_WIN32 を選んだのは、これが Microsoft が VC++ の中で定義しているものであり、VC++ のサンプルに従えるようコンパチビリティを持つのは良いことだと考えたからです。私たちは _MFC_VER を使って VC++ でコンパイルされるべきコードを指示しています。

gcc が動かないんですけど?

"gcc: installation problem, cannot exec `cpp': No such file or directory" というエラーが出た場合は、GCC_EXEC_PREFIX という環境変数が正しく設定されていません。その場合は、このリリースに付属している README.txt を読み直すべきです。というのは、他にも /tmp を作成するなどの必要な作業がされていないかもしれないからです。もしツールをデフォルトのディレクトリにインストールしたのであれば、 GCC_EXEC_PREFIX を設定する必要はありません。

make がなんか変なんですけど?

beta 19 以降に含まれる make は、win32 モードがデフォルトです。これはファイル名中にバックスラッシュが使えて、cmd.exe/command.com をサブシェルとして使います。このモードではいろいろ制限があり、特にエスケープ文字が許されません。こういう理由で、普通の UNIX の Makefile で make を行うには、 MAKE_MODE 環境変数を UNIX に設定しなければなりません。

beta 19 の GDB が動かない! 何が悪いの?

そのエラーが、"Tcl_Init failed: Can't find a usable init.tcl..." というものであれば、おそらく TCL_LIBRARY 環境変数の値が間違って設定されています。g:\cygnus\b19 以下にインストールしたのであれば、TCL_LIBRARY の値は G:/cygnus/b19/share/tcl8.0 (スラッシュはすべて前向き `/')に設定されていなければなりません。

"Unable to find main.tcl..." というエラーであれば、GDBTK_LIBRARY 環境変数が正しいパスではありません。g:\cygnus\b19 以下にインストールしたのであれば、GDBTK_LIBRARY は G:/cygnus/b19/share/gdbtcl (スラッシュはすべて前向き `/')に設定されていなければなりません。

"invalid command name 'create_command_window'" などのようなエラーの場合には、おそらく GDBTK_LIBRARY 環境変数の値に、前向きのスラッシュ`/' ではなくバックスラッシュ`\' が含まれています。

もしツールをデフォルトのディレクトリにインストールしたのであれば、これらの環境変数はどれも設定する必要はないはずです。

man/info ページはどこ行っちゃったの?

ディスクスペースとダウンロード時間を節約するために、man/info ファイルをバイナリインストールと一緒に提供するのは止めました。これはまだ man ページ、info リーダを提供していないからです。どちらのドキュメントもプロジェクトの ftp サイトから tar ファイルで利用可能です。あるいは WWW でオンラインドキュメントを見てください。

他のプロセッサ用の config ファイルはどこからダウンロードできるの?

ディスクスペースとダウンロード時間を節約するために、プロジェクトの ftp サイトから利用できるソースからは、x86 以外のプロセッサ用の config ディレクトリは取り除きました。もし他のホスト用にツールを再構築したいのであれば、該当するツールそれぞれの最新版ソースを Free Software Foundation (FSF) から手に入れなければなりません。

V って何ですか?

(`http://www.cs.unm.edu/~wampler/aboutv.html' より抜粋)

V は、異なったグラフィックインタフェースプラットフォーム上でさまざまなアプリケーションを開発するための、汎用 C++ GUI フレームワークです。これは、全て最新のインタフェース部品を使った最高水準の商用アプリケーションには向かないでしょうけれども、非常に完成度が高く、カスタムGUIアプリケーションの大部分に適しているものです。 V を使って開発されたアプリケーションは、プラットフォームネイティブの look&feel を持ち、さらにプラットフォームを超えた移植性があります。

V では、メニュー、ステータスバー、ツールバー、描画キャンバスなどを持ったウインドウ、汎用コントロール(ボタン、リスト、ラベル、テキストエントリ、チェックボタン、ラジオボタンなど)を持ったモーダルおよびモードレスダイアログを含む、ほとんどの GUI オブジェクトをサポートしており、またポータブルな印刷もサポートしています。

...

V はまた、多くのカスタムアプリケーションを作るためのすばらしいツールでもあります。これは研究所、小さなカスタムソフトウェアショップ、エンジニアリング会社、または個人でも、グラフィカルユーザインタフェースを必要とするとするアプリケーション開発、特に複数プラットフォーム上での必要がある人に向いているツールです。その設計のおかげで、V はネイティブの GUI ツールキットよりもとても簡単に学び、使うことができます。また、MFC や OWL のような大きなフレームワークよりも、簡単に学ぶことができます。これはフリーウェアですが、GNU Library General Public License に基づいてライセンスされ、公共の使用のためにソースコードが常に利用できます。

さらなる情報は、以下の V の WWW ページをご覧ください。 `http://www.cs.unm.edu/~wampler/vgui/vgui.html'.

なぜ DJGPP は使わないの?

DJGPP は同じようなアイデアですが、これは Win95 や Windows NT ではなく DOS 用のものです。DJGPP はアプリケーションに対して道理の通った操作インタフェースを提供するために、"DOS extender" を使っています。GNU-WIN32では全てのアプリケーションはネイティブ WIN32 なので、その必要はないのです。GNU-WIN32 では全ての Win32 API 関数を呼び出すことができ、Windows の GUI を使ったプログラムを書くこともできるのです。おそらくいつの日か、 GNU-WIN32 は Alpha や MIPS プロセッサ上でも同じように動くようになるでしょう。

DJGPP に関する詳しい情報は以下で取得できます。

`http://www.delorie.com'.

既知の問題、潜在的な問題

DLL 内における固定長配列

引数における // 形式のパス名を扱えないプログラム

DOS 特殊ファイル名

ユーザ定義 malloc

大文字/小文字が混在したファイル名

Cygwin32 ではどの Unix API 関数がサポートされているんですか?

ここから Cygwin32 ライブラリでサポートされている関数をリストするドキュメントの始まりです。

全ての POSIX.1/1990 と ANSI C 関数はこのファイルでリストされています。POSIX.1/1996 関数のいくらかはリストされていますが全てではありません。付加的な UNIX 互換関数や拡張 libc/libm 関数は Cygwin32 で提供されていますが、リストされているものとまだリストされてないものがあります。

ここにリストされていない関数が実装されているかどうかは、ソースの winsup/cygwin.din ファイルにその関数があるかどうかをチェックしてください。さらに、その関数がスタブでないことを確認するために、対応するソースコードを読んでおいた方が良いでしょう。最後に、 libc/libm の関数は(ここにリストされていない拡張関数も含めて) newlib の texinfo ドキュメントに記述されています。

特に断り書きがなければ、Windows 95 と NT のどちらでも実装されています。関連する標準への参照も(もしあれば)含まれています。 "cygwin32_" で始まる関数は Cygwin32 特有の関数です。

ANSI C ライブラリ関数

libc stdio (newlib/libc/stdio)
- clearerr: C 4.9.10.1
- fclose: C 4.9.5.1, P 8.2.3.2
- feof: C 4.9.10.2
- ferror: C 4.9.10.3
- fflush: C 4.9.5.2, P 8.2.3.4
- fgetc: C 4.9.7.1, P 8.2.3.5
- fgetpos: C 4.9.9.1
- fgets: C 4.9.7.2, P 8.2.3.5
- fopen: C 4.9.5.3, P 8.2.3.1
- fprintf: C 4.9.7.3, P 8.2.3.6
- fputc: C 4.9.7.3, P 8.2.3.6
- fputs: C 4.9.7.4, P 8.2.3.6
- fread: C 4.9.8.1, P 8.2.3.5
- freopen: C 4.9.5.4, P 8.2.3.3
- fscanf: C 4.9.6.2, P 8.2.3.7
- fseek: C 4.9.9.2, P 8.2.3.7
- fsetpos: C 4.9.9.3
- ftell: C 4.9.9.4, P 8.2.3.10
- fwrite: C 4.9.8.2, P 8.2.3.6
- getc: C 4.9.7.5, P 8.2.3.5
- getchar: C 4.9.7.6, P 8.2.3.5
- gets: C 4.9.7.7, P 8.2.3.5
- perror: C 4.9.10.4, P 8.2.3.8
- printf: C 4.9.6.3, P 8.2.3.6
- putc: C 4.9.7.8, P 8.2.3.6
- putchar: C 4.9.7.9, P 8.2.3.6
- puts: C 4.9.7.10, P 8.2.3.6
- remove: C 4.9.4.1, P 8.2.4
- rename: C 4.9.4.2, P 5.5.3.1
- rewind: C 4.9.9.5, P 8.2.3.7
- scanf: C 4.9.6.4, P 8.2.3.5
- setbuf: C 4.9.5.5
- setvbuf: C 4.9.5.6
- sprintf: C 4.9.6.5
- sscanf: C 4.9.6.6
- tmpfile: C 4.9.4.3, P 8.2.3.9
- tmpnam: C 4.9.4.4, P 8.2.5
- vfprintf: C 4.9.6.7
- ungetc: C 4.9.7.11
- vprintf: C 4.9.6.8
- vsprintf: C 4.9.6.9
libc string (newlib/libc/string)
- memchr: C 4.11.5.1
- memcmp: C 4.11.4.1
- memcpy: C 4.11.2.1
- memmove: C 4.11.2.2
- memset: C 4.11.6.1
- strcat: C 4.11.3.1
- strchr: C 4.11.5.2
- strcmp: C 4.11.4.2
- strcoll: C 4.11.4.3
- strcpy: C 4.11.2.3
- strcspn: C 4.11.5.3
- strerror: C 4.11.6.2
- strlen: C 4.11.6.3
- strncat: C 4.11.3.2
- strncmp: C 4.11.3.2
- strncpy: C 4.11.2.4
- strpbrk: C 4.11.5.4
- strrchr: C 4.11.5.5
- strspn: C 4.11.5.6
- strstr: C 4.11.5.7
- strtok: C 4.11.5.8
- strxfrm: C 4.11.4.5
libc stdlib (newlib/libc/stdlib, environ.cc, newlib/libc/include/machine/setjmp.h newlib/libc/include/assert.h)
- abort: C 4.10.4.1, P 8.2.3.12
- abs: C 4.10.6.1
- assert: C 4.2.1.1
- atexit: C 4.10.4.2
- atof: C 4.10.1.1
- atoi: C 4.10.1.2
- atol: C 4.10.1.3
- bsearch: C 4.10.5.1
- calloc: C 4.10.3.1
- div: C 4.10.6.2
- exit: C 4.10.4.3, P 8.2.3.12
- free: C 4.10.3.2
- getenv: C 4.10.4.4, P 4.6.1.1
- labs: C 4.10.6.3
- ldiv: C 4.10.6.2
- longjmp: C 4.6.2.1
- malloc: C 4.10.3.3
- mblen: C 4.10.7.1
- mbstowcs: C 4.10.8.1
- mbtowc: C 4.10.7.2
- qsort: 4.10.5.2
- rand: C 4.10.2.1
- realloc: C 4.10.3.4
- setjmp: C 4.6.1.1
- srand: C 4.10.2.2
- strtod: C 4.10.1.4
- strtol: C 4.10.1.5
- strtoul: C 4.10.1.6
- system: C 4.10.4.5
- wcstombs: C 4.10.8.2
- wctomb: C 4.10.7.3
libc time (times.cc, newlib/libc/time)
- asctime: C 4.12.3.1
- gmtime: C 4.12.3.3
- localtime: C 4.12.3.4, P 8.1.1
- time: C 4.12.2.4, P 4.5.1.1
- clock: C 4.12.2.1
- ctime: C 4.12.3.2
- difftime: C 4.12.2.2
- mktime: C 4.12.2.3, P 8.1.1
- strftime: C 4.11.6.2
libc signals (signal.cc, newlib/libc/signal)
- raise: C 4.7.2.1
- signal: C 4.7.1.1
libc ctype (newlib/libc/ctype)
- isalnum: C 4.3.1.1
- isalpha: C 4.3.1.2
- iscntrl: C 4.3.1.3
- isdigit: C 4.3.1.4
- isgraph: C 4.3.1.5
- islower: C 4.3.1.6
- isprint: C 4.3.1.7
- ispunct: C 4.3.1.8
- isspace: C 4.3.1.9
- isupper: C 4.3.1.10
- isxdigit: C 4.3.1.11
- tolower: C 4.3.2.1
- toupper: C 4.3.2.2
libm math (newlib/libm/math)
- acos: C 4.5.2.1
- asin: C 4.5.2.2
- atan: C 4.5.2.3
- atan2: C 4.5.2.4
- ceil: C 4.5.6.1
- cos: C 4.5.2.5
- cosh: C 4.5.3.2
- exp: C 4.5.4.1
- fabs: C 4.5.6.2
- floor: C 4.5.6.3
- fmod: C 4.5.6.4
- frexp: C 4.5.4.2
- ldexp: C 4.5.4.3
- log: C 4.5.4.4
- log10: C 4.5.4.5
- modf: C 4.5.4.6
- pow: C 4.5.5.1
- sin: C 4.5.2.6
- sinh: C 4.5.3.2
- sqrt: C 4.5.5.2
- tan: C 4.5.2.7
- tanh: C 4.5.3.3
libc misc (newlib/libc/locale, gcc/ginclude/stdarg.h)
- localeconv: C 4.4.2.1
- setlocale: C 4.4.1.1, P 8.1.2.1
- va_arg: C 4.8.1.2
- va_end: C 4.8.1.3
- va_start: C 4.8.1.1
POSIX.1/96 関数
プロセス基本操作 (3章)
- fork: P 3.1.1.1
- execl: P 3.1.2.1
- execle: P 3.1.2.1
- execlp: P 3.1.2.1
- execv: P 3.1.2.1
- execve: P 3.1.2.1
- execvp: P 3.1.2.1
- pthread_atfork: P96 3.1.3.1 -- 未実装
- wait: P 3.2.1.1
- waitpid: P 3.2.1.1
- _exit: P 3.2.2.1
- kill: P 3.3.2.1
- sigemptyset: P 3.3.3.1
- sigfillset: P 3.3.3.1
- sigaddset: P 3.3.3.1
- sigdelset: P 3.3.3.1
- sigismember: P 3.3.3.1
- sigaction: P 3.3.4.1
- pthread_sigmask: P96 3.3.5.1
- sigprocmask: P 3.3.5.1
- sigpending: P 3.3.6.1
- sigsuspend: P 3.3.7.1
- sigwait: P96 3.3.8.1 -- 未実装
- sigwaitinfo: P96 3.3.8.1 -- 未実装
- sigtimedwait: P96 3.3.8.1 -- 未実装
- sigqueue: P96 3.3.9.1 -- 未実装
- pthread_kill: P96 3.3.10.1 -- 未実装
- alarm: P 3.4.1.1
- pause: P 3.4.2.1
- sleep: P 3.4.3.1
プロセス環境 (4章)
- getpid: P 4.1.1.1
- getppid: P 4.1.1.1
- getuid: P 4.2.1.1
- geteuid: P 4.2.1.1
- getgid: P 4.2.1.1
- getegid: P 4.2.1.1
- setuid: P 4.2.2.1 (スタブ。ENOSYS をセットし、0 を返す)
- setgid: P 4.2.2.1 (スタブ。ENOSYS をセットし、0 を返す)
- getgroups: P 4.2.3.1
- getlogin: P 4.2.4.1
- getlogin_r: P 4.2.4.1 -- 未実装
- getpgrp: P 4.3.1.1
- setsid: P 4.3.2.1
- setpgid: P 4.3.3.1
- uname: P 4.4.1.1
- time: C 4.12.2.4, P 4.5.1.1
- times: P 4.5.2.1
- getenv: C 4.10.4.4, P 4.6.1.1
- ctermid: P 4.7.1.1
- ttyname: P 4.7.2.1
- ttyname_r: P 4.7.2.1 -- 未実装
- isatty: P 4.7.2.1
- sysconf: P 4.8.1.1
ファイル、ディレクトリ (5章)
- opendir: P 5.1.2.1
- readdir: P 5.1.2.1
- readdir_r: P96 5.1.2.1 -- 未実装
- rewinddir: P 5.1.2.1
- closedir: P 5.1.2.1
- chdir: P 5.2.1.1
- getcwd: P 5.2.2.1
- open: P 5.3.1.1
- creat: P 5.3.2.1
- umask: P 5.3.3.1
- link: P 5.3.4.1 (Win 95 と NT で link に失敗した場合はファイルをコピーする)
- mkdir: P 5.4.1.1
- mkfifo: P 5.4.2.1 -- 未実装!!!
- unlink: P 5.5.1.1
- rmdir: P 5.5.2.1
- rename: C 4.9.4.2, P 5.5.3.1
- stat: P 5.6.2.1
- fstat: P 5.6.2.1
- access: P 5.6.3.1
- chmod: P 5.6.4.1
- fchmod: P96 5.6.4.1
- chown: P 5.6.5.1 (Win 95 においてはスタブ。常に 0を返す)
- utime: P 5.6.6.1
- ftruncate: P96 5.6.7.1
- pathconf: P 5.7.1.1
- fpathconf: P 5.7.1.1
入出力基本操作 (6章)
- pipe: P 6.1.1.1
- dup: P 6.2.1.1
- dup2: P 6.2.1.1
- close: P 6.3.1.1
- read: P 6.4.1.1
- write: P 6.4.2.1
- fcntl: P 6.5.2.1 (注: fcntl(fd, F_GETLK,...) は未実装(errno に ENOSYS を設定して -1 を返す))
- lseek: P 6.5.3.1 (注: バイナリファイルに対してのみ正しく動作する)
- fsync: P96 6.6.1.1
- fdatasync: P96 6.6.2.1 -- 未実装
- aio_read: P96 6.7.2.1 -- 未実装
- aio_write: P96 6.7.3.1 -- 未実装
- lio_listio: P96 6.7.4.1 -- 未実装
- aio_error: P96 6.7.5.1 -- 未実装
- aio_return: P96 6.7.6.1 -- 未実装
- aio_cancel: P96 6.7.7.1 -- 未実装
- aio_suspend: P96 6.7.8.1 -- 未実装
- aio_fsync: P96 6.7.9.1 -- 未実装
デバイス、クラス特有関数 (7章)
- cfgetispeed: P96 7.1.3.1
- cfgetospeed: P96 7.1.3.1
- cfsetispeed: P96 7.1.3.1
- cfsetospeed: P96 7.1.3.1
- tcdrain: P 7.2.2.1
- tcflow: P 7.2.2.1
- tcflush: P 7.2.2.1
- tcgetattr: P96 7.2.1.1
- tcgetpgrp: P 7.2.3.1
- tcsendbreak: P 7.2.2.1
- tcsetattr: P96 7.2.1.1
- tcsetpgrp: P 7.2.4.1
C プログラム言語用の言語特有サービス (8章)
- abort: C 4.10.4.1, P 8.2.3.12
- asctime_r: P96 8.3.4.1 -- 未実装
- ctime_r: P96 8.3.5.1 -- 未実装
- exit: C 4.10.4.3, P 8.2.3.12
- fclose: C 4.9.5.1, P 8.2.3.2
- fdopen: P 8.2.2.1
- fflush: C 4.9.5.2, P 8.2.3.4
- fgetc: C 4.9.7.1, P 8.2.3.5
- fgets: C 4.9.7.2, P 8.2.3.5
- fileno: P 8.2.1.1
- flockfile: P96 8.2.6.1 -- 未実装
- fopen: C 4.9.5.3, P 8.2.3.1
- fprintf: C 4.9.7.3, P 8.2.3.6
- fputc: C 4.9.7.3, P 8.2.3.6
- fputs: C 4.9.7.4, P 8.2.3.6
- fread: C 4.9.8.1, P 8.2.3.5
- freopen: C 4.9.5.4, P 8.2.3.3
- fscanf: C 4.9.6.2, P 8.2.3.7
- fseek: C 4.9.9.2, P 8.2.3.7
- ftell: C 4.9.9.4, P 8.2.3.10
- ftrylockfile: P96 8.2.6.1 -- 未実装
- funlockfile: P96 8.2.6.1 -- 未実装
- fwrite: C 4.9.8.2, P 8.2.3.6
- getc: C 4.9.7.5, P 8.2.3.5
- getc_unlocked: P96 8.2.7.1 -- 未実装
- getchar: C 4.9.7.6, P 8.2.3.5
- getchar_unlocked: P96 8.2.7.1 -- 未実装
- gets: C 4.9.7.7, P 8.2.3.5
- gmtime_r: P96 8.3.6.1 -- 未実装
- localtime_r: P96 8.3.7.1 -- 未実装
- perror: C 4.9.10.4, P 8.2.3.8
- printf: C 4.9.6.3, P 8.2.3.6
- putc: C 4.9.7.8, P 8.2.3.6
- putc_unlocked: P96 8.2.7.1 -- 未実装
- putchar: C 4.9.7.9, P 8.2.3.6
- putchar_unlocked: P96 8.2.7.1 -- 未実装
- puts: C 4.9.7.10, P 8.2.3.6
- rand_r: P96 8.3.8.1 -- 未実装
- remove: C 4.9.4.1, P 8.2.4
- rewind: C 4.9.9.5, P 8.2.3.7
- scanf: C 4.9.6.4, P 8.2.3.5
- setlocale: C 4.4.1.1, P 8.1.2.1
- siglongjmp: P 8.3.1.1
- sigsetjmp: P 8.3.1.1
- strtok_r: P96 8.3.3.1 -- 未実装
- tmpfile: C 4.9.4.3, P 8.2.3.9
- tmpnam: C 4.9.4.4, P 8.2.5
- tzset: P 8.3.2.1
システムデータベース (9章)
- getgrgid: P 9.2.1.1
- getgrgid_r: P96 9.2.1.1 -- 未実装
- getgrnam: P 9.2.1.1
- getgrnam_r: P96 9.2.1.1 -- 未実装
- getpwnam: P 9.2.2.1
- getpwnam_r: P96 9.2.2.1 -- 未実装
- getpwuid: P 9.2.2.1
- getpwuid_r: P96 9.2.2.1 -- 未実装
同期 (11章)
- pthread_cond_broadcast: P96 11.4.3.1 -- 未実装
- pthread_cond_destroy: P96 11.4.2.1 -- 未実装
- pthread_cond_init: P96 11.4.2.1 -- 未実装
- pthread_cond_signal: P96 11.4.3.1 -- 未実装
- pthread_cond_timedwait: P96 11.4.4.1 -- 未実装
- pthread_cond_wait: P96 11.4.4.1 -- 未実装
- pthread_condattr_destroy: P96 11.4.1.1 -- 未実装
- pthread_condattr_getpshared: P96 11.4.1.1 -- 未実装
- pthread_condattr_init: P96 11.4.1.1 -- 未実装
- pthread_condattr_setpshared: P96 11.4.1.1 -- 未実装
- pthread_mutex_destroy: P96 11.3.2.1 -- 未実装
- pthread_mutex_init: P96 11.3.2.1 -- 未実装
- pthread_mutex_lock: P96 11.3.3.1 -- 未実装
- pthread_mutex_trylock: P96 11.3.3.1 -- 未実装
- pthread_mutex_unlock: P96 11.3.3.1 -- 未実装
- sem_close: P96 11.2.4.1 -- 未実装
- sem_destroy: P96 11.2.2.1 -- 未実装
- sem_getvalue: P96 11.2.8.1 -- 未実装
- sem_init: P96 11.2.1.1 -- 未実装
- sem_open: P96 11.2.3.1 -- 未実装
- sem_post: P96 11.2.7.1 -- 未実装
- sem_trywait: P96 11.2.6.1 -- 未実装
- sem_unlink: P96 11.2.5.1 -- 未実装
- sem_wait: P96 11.2.6.1 -- 未実装
メモリ管理 (12章)
- mlock: P96 12.1.2.1 -- 未実装
- mlockall: P96 12.1.1.1 -- 未実装
- mmap: P96 12.2.1.1
- mprotect: P96 12.2.3.1
- msync: P96 12.2.4.1
- munlock: P96 12.1.2.1 -- 未実装
- munlockall: P96 12.1.1.1 -- 未実装
- munmap: P96 12.2.2.1
- shm_open: P96 12.3.1.1 -- 未実装
- shm_unlink: P96 12.3.2.1 -- 未実装
実行スケジュール (13章)
- pthread_attr_getinheritsched: P96 13.5.1.1 -- 未実装
- pthread_attr_getschedparam: P96 13.5.1.1 -- 未実装
- pthread_attr_getschedpolicy: P96 13.5.1.1 -- 未実装
- pthread_attr_getscope: P96 13.5.1.1 -- 未実装
- pthread_attr_setinheritsched: P96 13.5.1.1 -- 未実装
- pthread_attr_setschedparam: P96 13.5.1.1 -- 未実装
- pthread_attr_setschedpolicy: P96 13.5.1.1 -- 未実装
- pthread_attr_setscope: P96 13.5.1.1 -- 未実装
- pthread_getschedparam: P96 13.5.2.1 -- 未実装
- pthread_mutex_getprioceiling: P96 13.6.2.1 -- 未実装
- pthread_mutex_setprioceiling: P96 13.6.2.1 -- 未実装
- pthread_mutexattr_getprioceiling: P96 13.6.1.1 -- 未実装
- pthread_mutexattr_getprotocol: P96 13.6.1.1 -- 未実装
- pthread_mutexattr_setprioceiling: P96 13.6.1.1 -- 未実装
- pthread_mutexattr_setprotocol: P96 13.6.1.1 -- 未実装
- pthread_setschedparam: P96 13.5.2.1 -- 未実装
- sched_get_priority_max: P96 13.3.6.1 -- 未実装
- sched_get_priority_min: P96 13.3.6.1 -- 未実装
- sched_getparam: P96 13.3.2.1 -- 未実装
- sched_getscheduler: P96 13.3.4.1 -- 未実装
- sched_rr_get_interval: P96 13.3.6.1 -- 未実装
- sched_setparam: P96 13.3.1.1 -- 未実装
- sched_setscheduler: P96 13.3.3.1 -- 未実装
- sched_yield: P96 13.3.5.1 -- 未実装
クロックとタイマ (14章)
- clock_getres: P96 14.2.1.1 -- 未実装
- clock_gettime: P96 14.2.1.1 -- 未実装
- clock_settime: P96 14.2.1.1 -- 未実装
- nanosleep: P96 14.2.5.1 -- 未実装
- timer_create: P96 14.2.2.1 -- 未実装
- timer_delete: P96 14.2.3.1 -- 未実装
- timer_getoverrun: P96 14.2.4.1 -- 未実装
- timer_gettime: P96 14.2.4.1 -- 未実装
- timer_settime: P96 14.2.4.1 -- 未実装
メッセージパッシング (15章)
- mq_close: P96 15.2.2.1 -- 未実装
- mq_getattr: P96 15.2.8.1 -- 未実装
- mq_notify: P96 15.2.6.1 -- 未実装
- mq_open: P96 15.2.1.1 -- 未実装
- mq_receive: P96 15.2.5.1 -- 未実装
- mq_send: P96 15.2.4.1 -- 未実装
- mq_setattr: P96 15.2.7.1 -- 未実装
- mq_unlink: P96 15.2.3.1 -- 未実装
スレッド管理 (16章)
- pthread_attr_destroy: P96 16.2.1.1 -- 未実装
- pthread_attr_getdetachstate: P96 16.2.1.1 -- 未実装
- pthread_attr_getstackaddr: P96 16.2.1.1 -- 未実装
- pthread_attr_getstacksize: P96 16.2.1.1 -- 未実装
- pthread_attr_init: P96 16.2.1.1 -- 未実装
- pthread_attr_setdetachstate: P96 16.2.1.1 -- 未実装
- pthread_attr_setstackaddr: P96 16.2.1.1 -- 未実装
- pthread_attr_setstacksize: P96 16.2.1.1 -- 未実装
- pthread_create: P96 16.2.2.1 -- 未実装
- pthread_detach: P96 16.2.4.1 -- 未実装
- pthread_equal: P96 16.2.7.1 -- 未実装
- pthread_exit: P96 16.2.5.1 -- 未実装
- pthread_join: P96 16.2.3.1 -- 未実装
- pthread_once: P96 16.2.8.1 -- 未実装
- pthread_self: P96 16.2.6.1 -- 未実装
スレッド特有データ操作 (17章)
- pthread_getspecific: P96 17.1.2.1 -- 未実装
- pthread_key_create: P96 17.1.1.1 -- 未実装
- pthread_key_delete: P96 17.1.3.1 -- 未実装
- pthread_setspecific: P96 17.1.2.1 -- 未実装
スレッドキャンセル (18章)
- pthread_cancel: P96 18.2.1.1 -- 未実装
- pthread_cleanup_pop: P96 18.2.3.1 -- 未実装
- pthread_cleanup_push: P96 18.2.3.1 -- 未実装
- pthread_setcancelstate: P96 18.2.2.1 -- 未実装
- pthread_setcanceltype: P96 18.2.2.1 -- 未実装
- pthread_testcancel: P96 18.2.2.1 -- 未実装
その他の関数
ネットワーク (net.cc) (POSIX 1.g による標準。これはまだ草稿段階?)
- accept
- bind
- connect
- getdomainname
- gethostbyaddr
- gethostbyname
- getpeername
- getprotobyname
- getprotobynumber
- getservbyname
- getservbyport
- getsockname
- getsockopt
- herror
- htonl
- htons
- inet_addr
- inet_makeaddr
- inet_netof
- inet_ntoa
- listen
- ntohl
- ntohs
- rcmd
- recv
- recvfrom
- rexec
- rresvport
- send
- sendto
- setsockopt
- shutdown
- socket
- socketpair
その他
- chroot (スタブ。ENOSYS をセットし、-1 を返す)
- closelog
- cwait
- cygwin32_conv_to_full_posix_path
- cygwin32_conv_to_full_win32_path
- cygwin32_conv_to_posix_path
- cygwin32_conv_to_win32_path
- cygwin32_posix_path_list_p
- cygwin32_posix_to_win32_path_list
- cygwin32_posix_to_win32_path_list_buf_size
- cygwin32_split_path
- cygwin32_win32_to_posix_path_list
- cygwin32_win32_to_posix_path_list_buf_size
- cygwin32_winpid_to_pid
- dlclose
- dlerror
- dlfork
- dlopen
- dlsym
- endgrent
- endpwent (訳注: 原文ではおかしな場所にあったのでここに追加)
- ffs
- fstatfs
- ftime
- get_osfhandle
- getdtablesize
- getgrent
- gethostname
- getitimer
- getmntent
- getpagesize
- getpgid
- getpwent
- gettimeofday: BSD
- grantpt
- initgroups (stub)
- ioctl
- killpg
- login
- logout
- lstat
- mknod (スタブ。ENOSYS をセットし、-1 を返す)
- memccpy
- nice
- openlog
- pclose
- popen
- ptsname
- putenv
- random
- readv
- realpath
- regfree
- rexec
- select
- setegid: SVR4 (スタブ。ENOSYS をセットし、0 を返す)
- setenv
- seterrno
- seteuid (スタブ。ENOSYS をセットし、0 を返す)
- setitimer
- setmntent
- setmode
- setpassent
- setpgrp
- setpwent
- settimeofday: BSD (スタブ。ENOSYS をセットし、-1 を返す)
- sexecl
- sexecle
- sexeclp
- sexeclpe
- sexeclpe
- sexecp
- sexecv
- sexecve
- sexecvpe
- sigpause
- spawnl (spawn 関数は Windows の C ライブラリを使用)
- spawnle
- spawnlp
- spawnlpe
- spawnv
- spawnve
- spawnvp
- spawnvpe
- srandom
- statfs
- strsignal
- strtosigno
- swab
- syslog
- timezone
- truncate
- ttyslot
- unlockpt
- unsetenv
- usleep
- utimes
- vfork: fork を呼び出すスタブ
- vhangup (スタブ。ENOSYS をセットし、-1 を返す)
- wait3
- wait4
- wcscmp
- wcslen
- wprintf
- writev

このプロジェクトには誰が関わっているの?

私は Geoffrey Noer (noer@cygnus.com) です。私は Cygwin32 ライブラリの現在の保守者で、特に公開用ベータリリースの管理をしています。私は受け取ったパッチや質問にはできる限り責任を持つように努力していますが、実際には私には全てのメールに対して答えることは不可能です。Win32 ツールのネットワークリリースの作成やヘルプは私の本来の仕事ではないので、メールでお答えできないこともあります。

Steve Chamberlain (sac@transmeta.com) 氏は Cygwin32 の元々の作者です。彼はオリジナルの Win32 依存のコードのほとんどを書き、beta 14までのリリースの全部作成し、他多くの GNU のツールを Win32 上で動作するように移植し、V を gnu-win32 ツールで動作するように移植しました。

Sergey Okhapkin (sos@prospect.com.ru) 氏は、たくさんのシグナルと例外処理のコードを書き直し、tty/pty のサポートを実装し、ライブラリ中の至る所で数え切れない貢献をしていただきました。

Chris Faylor (cgf@bbc.com) 氏はプロセス制御、環境のコードの大幅な修正に貢献し、strace 機構を再び動くようにしてくれました。最近では、シグナル関連のコードを一から書き直していただきました。

Philippe Giacinti (giac@dalim.de) 氏は dlopen、 dlclose、 dlsym、 dlfork、dlerror の実装に貢献していただきました。

Ian Lance Taylor (ian@cygnus.com) 氏は、必要とされていたパスを取り扱うコードを書き直していただき、コードの至る所でさまざまな修正をたくさんの貢献をしてくれました。

Tobin Brockett (tobin@cygnus.com) 氏は beta 19 リリース用に InstallShield ベースのインストーラを書いていただきました。

Jeremy Allison (jra@cygnus.com) 氏は、ファイルの扱いとプロセス制御の分野で多大な貢献をしていただき、select を一から書き直してくれました。

Doug Evans (dje@cygnus.com) 氏は beta 16 においてパス名を扱うコードを書き直すのに多大な時間を費やし、その他の数え切れない問題を修正してくれました。 Jason Molenda 氏と Mark Eichin 氏もまた多くの重要な貢献をしていただきました。

Kim Knuttila 氏と Michael Menissner 氏は PowerPC への移植に長時間参加していただきました。

そしてこのツールを使って、アドバイス、バグリポート、コード修正といった形でのたくさんの助力をして頂いた皆さん、本当にありがとう。これからもよろしく!

商用サイトでは、Windows NT/95 上のクロスコンパイラのサポートを Cygnus より購入することができます。詳細はinfo@cygnus.com へメールをお送りください。Win32 ネイティブツールの公式サポートは、現時点ではありません。

履歴

Release Beta 19 (Feb 26 1998)
これは重要なリリースです。これにはさらに新しいバージョンの Cygwin32 ライブラリが含まれています。Cygwin API は互換性のなくなる変更がなされたので、dll の名前は cygwinb19.dll に変更されました。これは以前に作成された実行プログラムを無効にしないようにするためです。

B19 でコンパイルされたアプリケーションが B18 でコンパイルされたアプリケーションを exec() するときは、B18 でコンパイルされた実行プログラムは普通の Win32 実行プログラムとして扱われることに注意してください。これはつまり、オープンしたファイルディスクリプタやその他の内部データは exec() 呼び出しにおいて継承されないということです。この理由は、cygwin ライブラリのバージョンの違いによって違った共有メモリ領域が使用されるからです。これはあなたのやろうとしていることによっては重大かも知れませんし、そうでないかも知れません。

Cygwin32 ライブラリの Beta 19 リリースは、引き続き GNU General Public License (GPL) に従ってライセンスされます。

コンパイラツールで使用される PE 形式の定義は、Microsoft のものにより近くなりました。これによって他のベンダの開発ツールとの間でより共同利用できるようになるでしょうが、しかしおそらくこの領域についてはまだまだやるべきことが多く残っているでしょう。この変更によって、以前作成されたオブジェクトファイル(.o)やスタティックライブラリファイル(.a)が使えなくなりますので、必要なものは忘れずに古い .o と.a ファイルを消して作成し直してくださいね!

最後に、古いシンボリックリンクはこのリリースで無効になります。 "system" 属性がシンボリックリンクの印として使われるようになり、これで fstat と他のファイル関連の呼び出しが非常にスピードアップされました。古いシンボリックリンクを作り直すか、あるいはそれらの "system" 属性フラグをセットすることで、正しく認識されるようになるでしょう。

新しいインストーラは、 program files のショートカットをインストールすることで全ての環境変数の設定を自動的に行います。このショートカットは全ての環境変数を正しく設定して bash プロンプトを立ち上げます。この結果、セットアップ処理は前回のリリースよりもよりきれいになりました。

ツールを最終的には移動させる人のために、デフォルトの環境変数を設定するバッチファイルが、 cygnus.bat という名前でインストールディレクトリのルートにインストールされます。ツールは/cygwin/b19 にインストールするようにコンパイルされているので、この場所にインストールしたときは、 bin ディレクトリがパスに入っていれば各ツールは「それだけで動く」はずです(特別な環境変数は何も必要ありません)。唯一の例外は、MAKE_MODE で、これは通常の UNIX風の make の振る舞いをさせたい場合に設定する必要があります - さらに詳しくは以下の make のノートを参照してください。

各ツール毎の変更:

Ian Lance Taylor 氏によって、 "windres" というリソースコンパイラが書かれました。これはウインドウリソースを、テキストの rc ファイルから COFF ファイルにコンパイルするのに使用されます。ソースは binutils サブディレクトリの中にあります。

たくさんのユーティリティがバージョンアップされました。 Beta 19には bash 2.01.1、 fileutils 3.16、gawk 3.0.3、 patch 2.5、 shellutils 1.16、 tar 1.12、textutils 1.22、texinfo 3.11 が含まれます。Cygwin32 上の bash は、数ある改良の中での特筆点として、ジョブコントロールが動作するようになりました。

sh の実行プログラムは、 Linux の Debian ディストリビューションの ash 0.2 になりました。このより小さくなったシェルを/bin/sh.exe として使うことで、 configure が大きくスピードアップします。

Bison 1.25 が追加されました。

Tcl/Tk はバージョン 8.0 にバージョンアップしました。互換性のあるバージョンの tix と itcl が追加されました。これらは全て Cygwin32 コンパチブルな configure ファイルが含まれていて、Win32 版の Tcl/Tk を UNIX 流の方法でビルドできます。

Expect 5.21.3 が含まれ、基本的には動作しています。

バイナリは Pentium ベースのシステムで速度が向上するように i686 最適化をオンにしてコンパイルされていますが、i386 以降のチップでも動作するはずです。

リンカ(ld)が強化されました。 -- dll をリンクするときに、idata3 ターミネータが自動的に追加されるようになりました。

kill はシグナルの名前の引数をサポートするようになりました。ps はプロセスの開始時間情報を表示するようになりました。

デフォルトのツールのインストールでは詳細は隠されますが、makeユーティリティのデフォルトは Win32 モードになりました。これはサブシェルとして cmd.exe/command.com を使うというモードです。このモードではファイル名にバックスラッシュが使えます。UNIX プログラムをビルドするには MAKE_MODE 環境変数を "UNIX" に設定する必要があります。こうすることでサブシェルに sh.exe を使用する従来の振る舞いになるでしょう。

Cygwin32 API (cygwin.dll) の変更:

インタフェースはより明確になりました。libc、libm と UNIX 互換関数が含まれています。libgcc.a の外部名は含まれません。これによってより安定したインタフェースになるはずです。インタフェースのドキュメントは calls.texinfo を参照してください。

dll 全体の振る舞いを制御する環境変数は、 CYGWIN32 という変数一つだけになりました:

set CYGWIN32=[no]title [no]strip_title [no]binmode [no]glob strace=mask:cache,file [no]tty

"set CYGWIN32=title tty" と設定すれば、tty のサポート(以下参照) を行い、現在の実行プロセスをタイトルバーに表示します。

B19 では以下のサポートが追加されています:
- tty と仮想 tty デバイス。今のところ、tty はデフォルトではオフです。これは console を取得するのは、 Cygwin コンソール内で Cygwinではないコンソールプログラムを使用するときに問題を引き起こすからです。これをオンにするには、環境変数 CYGWIN32 に "tty" を含むように設定します。
- ハードリンク(NTFS ファイルシステム上の NT が必要)。使用不能のときは(NTFS 以外のファイルシステム上では)、link() は以前のリリースで行っていたように当該ファイルのコピーを作ります。
- SIGWINCH シグナル。tty 制御が有効のとき、プロセスは画面サイズが変更されたときに SIGWINCH シグナルを受け取ります。
- 有効な端末エスケープシーケンスの追加: <ESC>[n1;n2r によるスクロール領域の設定と、xterm のエスケープシーケンスを使ったコンソールタイトルの設定: <ESC>[2;new title^G 。
以下の関数が追加されました:
- ptsname, grantpt, unlockpt
- login, logout, ttyslot, ctermid
- cfgetispeed, cfgetospeed, cfsetispeed, cfsetospeed
- setitimer, getitimer, ftime, tzset
- wait3, wait4, pause, sigpause
- getpgid, killpg, setegid (stub)
- strlwr, strupr
- sexecve, sexecl, sexecle, sexeclp, sexeclpe, sexecv, sexecp, sexecvpe
- rcmd, rresvport, rexec
- strsignal, strtosigno
- dlopen, dlsym, dlclose, dlerror
- inet_netof, inet_makeaddr
- socketpair
- fpathconf, realpath, chroot (stub)
- initgroups (stub), getgroups
- random, srandom
以下の関数は削除されました:
- ScreenCols, ScreenGetCursor, ScreenRows, ScreenSetCursor
- getkey, kbhit
- crypt (stub)
- libgcc.a の全ての外部名
Winsock dll (wsock32.dll) はもはや Cygwin32 dll に暗黙のうちにリンクされることはなくなりました。代りに、プロセスが Cygwin32 のネットワーク関数を最初に呼び出したときに、LoadLibrary によって明示的にロードされます。これによって多くのプロセスはかなりスピードアップします(configure で約 20%)。

シグナル関連のコードは一から書き直されました。パスを扱うコードのほとんども同様です。

ファイル名展開(globbing)と getopt のコードは BSD 派生のコードに置き換えられました。正規表現のコードは Harry Spencer 氏の PD な実装に置き換えられました(訳注:おそらく Henry Spencer 氏の間違い。あと PD とは?)。

Doug Lea 氏の malloc が cygwin から公開されるデフォルトの malloc として使用されるようになりました。この malloc はスピードとコンパクトさのバランスを非常にうまくとっていますが、しかしすでに free されているメモリを free しようとするのを許してくれません。すなわち、セグメンテーション違反を引き起こします。

bsearch 関数は書き直されました。

Alt Gr キーの振る舞いはこのリリースで変更されました。左 alt キーは今までどおり ESC キーシーケンスを生成します。右 alt(Alt Gr) キーは国ごとのキーボードレイアウトに従った文字が生成されるようになりました。

プロセスは、 CYGWIN32 環境変数に "title" を含めない限りタイトルバーに名前を表示しなくなりました(上記参照)。

複数の cygwin.dll は、それらが同一(同時にビルドされたもの)でない限り、同じメモリ空間を使わなくなりました。これによって互換性のない共有メモリの使い方をする複数の dll を同時に走らせることができます。これは buggy な cygwin.dll をデバッグする機能でもあります。最新の cygwin.dll をシステム上に一つだけ残すようにすれば、全ての cygwin プロセスが同じ共有メモリ空間に存在するということが保障されるでしょう。

/ のマウントのデフォルトはもはや C: ではありません。システムドライブ(OS がインストールされているところ)がデフォルトになりました。

標準のダイナミックライブラリローダ関数 dl* が利用できるようになりました。 Cygwin32 B19 は fork の後に正しくデータをコピーし、親プロセスにロードされていた DLL を自動的に再ロードするようになりました｡さらに、DLL はロードされるときに正しく初期化され、グローバルコンストラクタが呼ばれるようになりました。グローバルデストラクタは DLL が detach されるときに呼び出されます。親プロセス中で dlopen や dlsym によって得られたハンドルは、fork された子プロセスの中でもアクセス可能です。LD_LIBRARY_PATH 環境変数が dlopen 検索に使用されます。

cygwin32 で作成された .dll 内では <cygwin32/cygwin_dll.h> ファイルをインクルードして、これらの関数を使用する .dll を作成するには DECLARE_CYGWIN_DLL(dll-entry-point) 行を使用してください。
Release Beta 18 (May 6 1997)
これは重要なリリースです。新しい cygwin.dll は以前リンクされたアプリケーションとのバックワードコンパチビリティがありますが、内容は大きく変わっています。
インストール処理が完全に変更され、 InstallShield5 ベースのインストーラを使うようになっています。これにより過去に経験した数々のインストール時の問題を減らしてくれます。しかしながら、配布ファイルに付属している README.txt で説明されているように、環境変数は未だに手で設定する必要があります(将来のgnu-win32 インストーラには、これを自動的に行う機能を持たせるかもしれません)。
各ツール毎の変更:

GCC のコンパイル時間が fork() の代りに spawn() を使うことによって、 20-30% 向上しました。

GCC は、環境変数(COMPILER_PATH、 LIBRARY_PATH、 C_INCLUDE_PATH、 CPLUS_INCLUDE_PATH、 OBJC_INCLUDE_PATH)の値に、 Win32 と POSIX 形式のパス名(あるいはパス名リスト)のどちらでも受け付けます。

GDB には tcl/tk ベースの GUI(gdbtk) が付属します。"gdb -nw" として起動することによって、コマンドライン gdb を起動することもできます。

bash は起動時に、 /tmp が存在しており、かつそれがディレクトリであることを確認します。そうでない場合には文句を言います。

gcc と ld に -s をつけて実行すると不正な実行ファイルが作成されていました。これに関する bfd のバグが修正されました。

String.h と string.h(と同様なヘッダファイルの組)が衝突して、インクルードしたものと違う方が読まれてしまうことを修正しました。

トップレベルの install-sh スクリプトは、foo をインストールしようとして foo が存在しない時は、foo.exe をインストールしようとします。これで多くの Unix ソフトウェアのインストールの問題が解決します。

dlltool に -I オプションをつけて起動することにより、.def ファイルの IMPORT 宣言が試験的にサポートされます。ぜひ気軽にこれを経験してみてください。ただしこの機能がより広くテストされるようになったら、このフラグはなくなるでしょう。

time はバージョン 1.7 に上がりました。

make はバージョン 3.75 に上がりました。

make は VPATH 変数で、Win32 と POSIX のパス名リストをどちらでも受け付けます。

Cygwin32 API (cygwin.dll) の変更:

The following is now supported:

以下がサポートされています:
- UNC パス
- コンソールモードの逆インデックスエスケープ(訳注:すみません。訳者はこれが何を指すのか分かっていません。どなたかご教示ください)
- socket と handle が組み合わされた select() のブロッキング
- ディレクトリのシンボリックリンク
- 子プロセスの、親プロセスの変更
以下の関数が追加されました:
- mmap(), mprotect(), msync(), munmap(). fork() changed to support these.
- fsync(), statfs(), fstatfs().
- getprotobynumber() and getservbyport().
- get_osfhandle(), cwait().
- spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnv(), spawnve(), spawnvp(), spawnvpe().
- nice().
- sigpending(), sigsuspend()
- NT のみ, chown(), getgrgid(), getgrnam(), endgrent(), getgrent(), setpwend(), getpwent(), endpwent(). Win95 ではこれらは未だにスタブ関数です。
かなり改善されたシグナル、例外ハンドラがサポートが追加されています。 kill シグナルはかなり良く働くようになりました(bash でコントロールC が働きます)。

シェルスクリプトが、常にデフォルトの /bin/sh ではなく、#! の後ろに指定されたシェルで動くようになっています。

浮動小数点レジスタが crt0.o の中で正しく初期化されるようになっています。

com ポートのようなディスク以外のファイルのオープン時には、シンボリックリンクであるか、実行可能であるかというチェックはもはや行いません。

コンソールタイトルは、実行中のプロセスの名前がセットされるようになっています。

winsock はアプリケーションの起動時に初期化されるようになっています。

reent_data がプライベートアドレス空間から cygwin.dll に移動しました。

system() 呼び出しは、fork()/exec() ではなく spawnvp() を呼び出すようになっています。

NT 拡張属性に対するサポートが追加されましたが、あまりにも遅くなってしまうので今のところ無効にしてあります。これをシンボリックリンクや実行可能属性のファイル状態を記憶するのに使用したいのです。

NT 上でのみ、 mkpasswd と mkgroup ユーティリティが、正しい /etc/passwd と /etc/group を生成します。

以前のリリースではマウントポイントはレジストリの "Cygnus Support" 以下に格納されていました。これは beta 18 より "Cygnus Solutions" に変更されました。レジストリエディタ(NTでは regedit)を使って古いエントリの名前を変更するか、あるいは単にもう一度マウントを行ってください。そうすれば cygwin.dll が自動的に新しいものを作ります。

マウントポイントは、30 文字ではなく、最大 MAX_PATH までの長さを取ることができます。
Release Beta 17.1 (Dec 10 1996) Win 95 で configure が動くように、再びパッチが適用されました。 ld はデフォルトの実行ファイル名として "a.exe" を作成するように変更されました。
Release Beta 17 (Dec 7 1996) Cygnus Developers' Kit (CDK) と User Tools の両方を全て正しくインストールすれば、x86 NT 上のツールをネイティブにリビルドすることが可能になりました。 cygwin.dll に大掛かりな変更が行われたにも関わらず、以前にビルドされたアプリケーションを使うことを妨げるものは何もありません。新しい DLL は私たちの知る限り、beta 16 と互換性を持っています。beta 14 でビルドされたプログラムはやはり beta 17 の DLL でも動かないので、それらを動かすためには再リンクする必要があるでしょう。 Cygwin32 API を形作る winsup ファイルは GNU General Public License のもとに置かれるようになりました。詳細は添付のプレスリリースを参照してください。
各ツール毎の変更:
gcc はデフォルトで -lkernel32 をリンクし、また mwindows がセットされたときは -luser32 -lgdi32 -lcomdlg32 がリンクされるようになっています。その他の重要な変更として、実行プログラムを作るとき、-o の引数に foo を与えると foo.exe を作成するようになりました。 dlltool には、オプションの中でコンソールか GUI かの選択を行う --subsystem の扱いを良くするパッチが入っています。 ld はスタックの予約サイズを大きく取るように変更されました。これは NT 上でのネイティブなツール群をビルドするのに必要となります。 C++ のヘッダは正しく設定された GCC_EXEC_PREFIX 環境変数によって与えられます。 fileutils と make の新バージョンが含まれています。findutils が追加されました。
Cygwin32 API (cygwin.dll) の変更:
Scott Christley の、標準 Win32 dll 用のヘッダ、def ファイルが統合されました。以前の Cygnus ヘッダでのみ提供されていたものはすべて適切な場所に追加されました。私たちのヘッダから抜き出して作った標準 Win32 ヘッダ名の管理ファイルがあるので、ある特定のヘッダファイルをインクルードしようとしているプログラムも動作します。より完全なヘッダを持つことで、 Win32 のネイティブプログラミングが簡単になりました。 select は一から書き直しました。新しいものは全てのソケットと全てのハンドルを扱うことができます。タイムアウト付きのハンドルどソケットはまだ実装されていません。select はブロッキングを行うようになり、CPU を働かせません。ファイルハンドル処理は大きく書き換えられました。 fhandler 配列は共有メモリの中ではなく、ローカルメモリの中に移動しました。これはいくつかの振る舞いを改善します。このサポートのために大きな変更がありました。 ansi/vt100のコンソールサポートがかなり完全なものとなっています。いくつかの新しいファイルロッキングがサポートされました。矢印キーがサポートされました。プロセス制御がさらに改善されました。 fork() の重大なバグが修正されました。 system() 呼び出しが動作するようになっています。 unlink() はファイルを削除しようとする前に、読み出し専用のファイルを書き込み可にモードを変更します。これにより、rm が読み出し専用ファイルに対して何度も "out of queue slots" というメッセージを出して削除できなかった、という未解決の問題が修正されます。テキストモード読み出しが書き直されました。新しい syslog によって、NT 上ではイベントログへ、Win 95 ではファイルヘログを取ることができます。シンボリックリンクが有効です。 readv() と writev() が実装され、公開されました。 MS との互換性のために、dll からの関数の export を、 funcname に加えて _funcname として export します。私はこの事実を利用しないように提案します。ただし、すでにこの方法で C ライブラリをアクセスするようになっているコードをビルドする場合はこの限りではありません。ほとんど全てのソースコードは C++ のファイルになっています。
Release Beta 16 (Aug 30 1996) パス名の扱いは完全に書き直されました。bash で Q: ドライブを参照するには、//q/ で参照できるようになりました。もしくは、"mount Q: /q" とタイプすることで、Q: ドライブが /q として見えるようになります。 Windows 95 と NT 4.0b2 上で、i386 の Plum Hall positive C 適合試験にパスしました。 fork は以前は dll 内からのアクセスはできませんでした。もはやそんなことはなくなり、既に動いているシステムや popen コールを追加することができます。 getdomainname は、レジストリからの情報を取得して動作します(以前は単に "cygnus.com" を返していた)。 readdir で errno が正しくセットされないバグが修正されました。これでディレクトリをまたがった diff が動かない問題が修正されました。シグナル関数内でのエラーチェックが改善されました。winsock の初期化は cygwin32_socket 内で checkinit を呼ぶことで行われます(これは、最初にこの処理を行う関数を呼ぶ必要があったというバグを修正します。)。新規関数: sigaddset, sigismember, sigfillset, sigemptyset sysdef ファイルにあった余分なアンダースコアを取り除きました。 cygwin.dll に関連付けられるメジャーおよびマイナーバージョン番号ができました。メジャー番号は互換性のなくなる変更が行われたときのみ変わり、マイナー番号は、古いアプリケーションの再リンクを必要としない程度の、何らかの変更が DLLに対して行われたときに変わります。 include/sys/param.h の中の HZ の値を、正しい値 1000 に変更しました ("time sleep 5" が 50 を返す、と言われていたバグが修正されます)。 i386 と ppc プロセッサの両方で、例外の扱いがいろいろと修正されました。 Cygnus Kerberos を動作させるために必要な time 関連が、いろいろと修正されました。 time 用新規関数: gmtime, corelocaltime spawn と fork にさまざまな修正が行われました。仮想 Unix プロセス処理が追加されました。新しく ps と kill コマンドが追加されました。 Control-Z は、テキストモードでオープンされたファイル中では、正当な EOF 文字として扱われるようになりました。lseek はバイナリモード中でのみ動作します。 select が改訂されました。その他さまざまな変更がありました。さらに詳細な情報は、ソースコードの winsup/ChangeLog ファイルをあたってください。プリプロセッサのマクロ定義の構成が変更されました。アプリケーションは、 Win32 API へのアクセスのチェックを行うためには __WIN32__ ではなく _WIN32を、また Cygwin32 環境の存在のチェックには__CYGWIN32__ を使わなくてはなりません。 GNU findutils、GNU dbm、GNU bison、GNU less、ncurses、ftp、finger、rcl、 cvtres、V はもはや含まれません。これは将来変更されるかもわかりませんが。以前のリリースでビルドされた古いアプリケーションは、新しい cygwin.dll と再リンクしなければなりません。
Release Beta 14 (April 10 1996) いくつかのバグが修正されています。GDBM と m4 がリリースに入っています。 GCC は cc1 などのために標準インストールディレクトリを使用するようになります。 gnu-win32 版 V が含まれました。これで Unix と Windows で変更せずに動作するグラフィックアプリケーションを書くことができます。V の一部は PPC でも動作します。標準の DOS シェルからプログラムを実行した場合、DLL はコマンドライン引数にある全てのワイルドカードを展開します。従って ls *.exe は、bash からでなくとも、あなたの思った通りに動きます。 ncurses と less が含まれました。DLL の vt100 エミュレーションは完全ではなく、ncurses は全て正しくは動作しません。そのため、less は多少役に立ちません(訳注:原文は "Hence less is more or less useless.")。これは新しい DLL で修正されるかもしれません(もし何か curses を利用するものを使いたい場合には、TERM と HOME 環境変数を設定するのを忘れないでください)。 main を省略すると、ライブラリは WinMain を通常の方法で呼び出そうとします。 ^C は Windows 95 上での動作がだいぶ良くなりました。これはまだ完全に正しくはないけれども、少なくともほとんどの場合は今の作業を中断し、ほとんどの場合はマシンをクラッシュさせません。 bash のセッションを2つ以上平行して開始することができます。いくつかのネットワークのサポートが追加されました。telnet.exe が提供されているにも関わらず、それが動作しないのは分かっていますので、バグ報告は送らないでください。新しい DLL で動かすにはアプリケーションを再リンクする必要があるでしょう。 DLL はそれ自身の .zip ファイルでもリリースされていますので、その他のものが必要ない場合には、全てのものをダウンロードする必要はありません。
Release Beta 13 (Feb 9 1996) デフォルトのファイルモードをレジストリで変更できます。 2つのリソースツールが含まれています。同じ綴りで大文字、小文字だけが違うファイル名を使えます。厄介な bash がハングするバグが修正されました。 raw フロッピーディスクにアクセスできます。
Release Beta 12 (Jan 4 1996) bash から非 gnu-win32 アプリケーションを実行できます。 mount コマンドを使って、別のディレクトリをマウントできます。最低限の ANSI 端末エミュレーションが含まれました。パッケージがより小さく、論理的なまとまりに分割されました。 /d<name> 機構はなくなりました。
Release Beta 11 ftp サイトへの途中で何かが壊れちゃいました。
Release Beta 10 (Dec 5 1995) bash 内で環境変数を渡すことができます。たくさんのものがあらかじめコンパイルされて提供されました。標準 FSF リリースとの diff が提供されました。自分自身でホストになります。シンボリックリンクをサポートします。ディレクトリレイアウトがより unix 風に変更されました。 c 以外のドライブへのアクセスする方法が新しくなります。 i:\foo.cc が /di/foo.cc になります。 fork の厄介なバグが見つかり、修正されました。CPP は環境変数で与えたディレクトリを検索するようになりました。
Release Beta 9 libc と libm を全て共有ライブラリ内に入れました。これでいくつかのバイナリのサイズは、猛烈に小さくなります。例えば、ls は 82,949 バイトから 26,624 バイトになります。 "Hello World" は 2564 バイトの大きさです。これは舞台裏で行われているものの大きなスピードアップの初舞台です。別々のプロセスは、共有メモリを使って通信します。レジストリをほんのちょっと使います。 DLLTOOL は「とても」早くなりました。 DLL を割り付けたときについての小さな問題がいくつか修正されました。
Release Beta 8 GDB が動きます。 GCC はデバッグ情報を生成するようになりました。これは「非常に巨大な」実行ファイルを作り出します。でも、幸運なことに strip も動作します。クォーティングを動作させるために、さらなる作業が行われました。 termios の簡単なサポートが newlib に追加されました。パスの表現にもっとよい方式をとります。例えば //c/foo は c:\foo のことです。
Release Beta 7 再び Win 95 で動きます(これが Beta 6 が宣伝されなかった理由)。パーミッションはよりうまくごまかせるようになります。デモのソースは、win32 バイナリツリーを全て ftp しなくても利用できます。
Release Beta 6 DLL を作成できるようになりました。小さなデモが含まれています。 tcl、byacc、fileutils、diff、make が含まれています。
Release Beta 5 最近のバージョンの Win95 上での動作を妨げるものを全て修正しました。 vfork と exec の変なところが修正されました。 Import ライブラリは、ただの .o ファイルではなく本当のライブラリになりました。デバッグ情報はバイナリイメージとライブラリから取り除かれました。これは gdb が動くようになるまではただの無駄ですから。 4つの主要な import ライブラリを書き入れました。 win*.h ファイルは <foo>/include/sys ではなく <foo>/include にインストールされるようになりました。これで箱から出してすぐコンパイルできるものが増えるでしょう。
Release Beta 4 PE サポートが修正されました。プログラムは NT 3.1 、NT 3.5、NT 3.51 、 WIndows 95 上で動作します。 GUI プログラムを作成できます。他の三つの DLL の .DEF ファイルが開始されました。新しい GUI のデモプログラム。 Cライブラリはテキストファイルとバイナリファイルを区別します。従って、ツールによって生成されたテキストファイルは、DOS が大好きな、行末の見慣れた ^M が入ります。 Cygnus の Doug Evans は、execve、opendir やその他さまざまなすごいことについて、素晴らしいサポートをいっぱい追加しました。例外処理が良くなりました。
Release Beta 3 古すぎて覚えてません。

著作権(copyrights)はどうなっていますか?

全般的な考え

ほとんどのツールは GNU General Public License (GPL) で保護されていますが、他のいくつかはパブリックドメインであり、その他は Berkeley スタイルの著作権を持っています。GNU GPL の「制限」を全うすると、基本ルールは、もし何かのバイナリを配布すれば、ソースも利用できるようにしなければならない、ということです。全詳細については、以下の GNU GPL の文章を必ず読んでください。

ソースコードの winsup サブディレクトリにある Cygwin32 API ライブラリもまた、GNU GPL によって保護されています。デフォルトでは全ての実行プログラムはこのライブラリ(と、 GPL に従った Cygwin32 glue (糊付け)コードを含むプロセス)をリンクしています。これは、コンパイルした実行プログラムが Cygwin32 ライブラリを使わないようにあなたがツールを修正しない限り、あなたのコンパイルしたプログラムも誰でもソースコードが利用可能な GPL で配布されるフリーソフトウエアになる、という意味です。

b19 リリースから、Cygwin32 は GPL のライセンスでも、独立した Cygwin32 商用ライセンスでもどちらでも利用できます。商用ライセンスについてのさらなる情報は info@cygnus.com までご連絡ください。

GNU GENERAL PUBLIC LICENSE

		   GNU GENERAL PUBLIC LICENSE
		      Version 2, June 1991

 Copyright (C) 1989, 1991 Free Software Foundation, Inc.
                          675 Mass Ave, Cambridge, MA 02139, USA
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.

			    Preamble

  The licenses for most software are designed to take away your
freedom to share and change it.  By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users.  This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it.  (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.)  You can apply it to
your programs, too.

  When we speak of free software, we are referring to freedom, not
price.  Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.

  To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.

  For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have.  You must make sure that they, too, receive or can get the
source code.  And you must show them these terms so they know their
rights.

  We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.

  Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software.  If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.

  Finally, any free program is threatened constantly by software
patents.  We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary.  To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.

  The precise terms and conditions for copying, distribution and
modification follow.

		    GNU GENERAL PUBLIC LICENSE
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License.  The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language.  (Hereinafter, translation is included without limitation in
the term "modification".)  Each licensee is addressed as "you".

Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope.  The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.

  1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.

You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.

  2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:

    a) You must cause the modified files to carry prominent notices
    stating that you changed the files and the date of any change.

    b) You must cause any work that you distribute or publish, that in
    whole or in part contains or is derived from the Program or any
    part thereof, to be licensed as a whole at no charge to all third
    parties under the terms of this License.

    c) If the modified program normally reads commands interactively
    when run, you must cause it, when started running for such
    interactive use in the most ordinary way, to print or display an
    announcement including an appropriate copyright notice and a
    notice that there is no warranty (or else, saying that you provide
    a warranty) and that users may redistribute the program under
    these conditions, and telling the user how to view a copy of this
    License.  (Exception: if the Program itself is interactive but
    does not normally print such an announcement, your work based on
    the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole.  If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works.  But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.

In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.

  3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:

    a) Accompany it with the complete corresponding machine-readable
    source code, which must be distributed under the terms of Sections
    1 and 2 above on a medium customarily used for software interchange; or,

    b) Accompany it with a written offer, valid for at least three
    years, to give any third party, for a charge no more than your
    cost of physically performing source distribution, a complete
    machine-readable copy of the corresponding source code, to be
    distributed under the terms of Sections 1 and 2 above on a medium
    customarily used for software interchange; or,

    c) Accompany it with the information you received as to the offer
    to distribute corresponding source code.  (This alternative is
    allowed only for noncommercial distribution and only if you
    received the program in object code or executable form with such
    an offer, in accord with Subsection b above.)

The source code for a work means the preferred form of the work for
making modifications to it.  For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable.  However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.

If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.

  4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License.  Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.

  5. You are not required to accept this License, since you have not
signed it.  However, nothing else grants you permission to modify or
distribute the Program or its derivative works.  These actions are
prohibited by law if you do not accept this License.  Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.

  6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions.  You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.

  7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License.  If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all.  For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.

If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.

It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices.  Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.

This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.

  8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded.  In such case, this License incorporates
the limitation as if written in the body of this License.

  9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time.  Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.

Each version is given a distinguishing version number.  If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation.  If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.

  10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission.  For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this.  Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.

			    NO WARRANTY

  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.

  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

		     END OF TERMS AND CONDITIONS

	Appendix: How to Apply These Terms to Your New Programs

  If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.

  To do so, attach the following notices to the program.  It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.

    <one line to give the program's name and a brief idea of what it does.>
    Copyright (C) 19yy  <name of author>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Also add information on how to contact you by electronic and paper mail.

If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:

    Gnomovision version 69, Copyright (C) 19yy name of author
    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
    This is free software, and you are welcome to redistribute it
    under certain conditions; type `show c' for details.

The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License.  Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.

You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary.  Here is a sample; alter the names:

  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
  `Gnomovision' (which makes passes at compilers) written by James Hacker.

  <signature of Ty Coon>, 1 April 1989
  Ty Coon, President of Vice

This General Public License does not permit incorporating your program into
proprietary programs.  If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library.  If this is what you want to do, use the GNU Library General
Public License instead of this License.

Geoffrey Noer noer@cygnus.com

日本語訳への注

この文書の翻訳は Keisuke Mori(ksk@kt.rim.or.jp) が行いました。ただし訳者はこの文書の内容に関していかなる責任も負うものではなく、また Cygnus に対していかなるサポートを行うものでもありません。もちろん誤訳の指摘、その他アドバイスなどは歓迎いたします。

なお、訳文中特に断りなく "DLL"、"(これらの)ツール" などとある場合、ほとんどはそれぞれ cygwin.dll と、GNU-Win32 の(usertools などの)ディストリビューションに含まれるツール類、のことを指しています。

謝辞: この文書を翻訳、公開するにあたって、公開を快く承諾してくださった Geoffrey Noer 氏、拙訳にご意見をくださった石尾孝弘(BERO) 氏に感謝いたします。

Last Modified: Sat Mar 7 21:18:28 PST 1998