3.7.1 gauche-config - 設定を問い合わせる ¶

Program: gauche-config [option] ¶

Without options, prints the command usage. With an option, prints the string associated to the option, which is determined at configuration time.

Here are some examples. Note that output may vary on your platform.

• Print the running architecture:

  $ gauche-config --arch
  x86_64-pc-linux-gnu
  

• Print the library flags required to link programs using Gauche:

  $ gauche-config -l
  -lgauche-0.98 -lmbedtls -lcrypt -lrt -lm  -lpthread
  

• Print the include path flags required to comple Gauche extension.

  $ gauche-config -I
  -I/usr/lib/gauche-0.98/0.9.15/include
  

The command accepts the following arguments. You can only give at most one.

一般のパラメータ:

-V

現在のGaucheのバージョン

Gaucheを使ったアプリケーションのコンパイルのためのパラメータ:

-I

Gaucheを使ったプログラムをコンパイルするのに必要なインクルードパスオプション (Gaucheのインストール先のパスが空白を含んでいる場合、これは 使えません。下の–incdirsを見てください。)

-L

Gaucheを使ったプログラムをコンパイルするのに必要なライブラリパスオプション (Gaucheのインストール先のパスが空白を含んでいる場合、これは 使えません。下の–incdirsを見てください。)

-l

Gaucheを使ったプログラムをリンクする時に必要なライブラリオプション

--cc

このGaucheをコンパイルする時に使われたCコンパイラ名

--cpp

Cプリプロセッサを走らせるコマンド

--ac

Gauche用のautoconfマクロがインストールされているディレクトリ名

--reconfigure

現在インストールされているGaucheに使われたconfigureのオプション

--arch

autoconf形式のアーキテクチャシグネチャ (cpu-vendor-kernel-os)

--incdirs

--archdirs

それぞれ、インクルードファイルとライブラリファイルが探されるディレクトリのリスト。 各ディレクトリ名は、それが空白を含んでいる場合はクオートされています。また、 それぞれのディレクトリ名の間はUnixでは ’:’、Windowsでは ’;’ で区切られています。

--local-incdir

--local-libdir

これらは、追加のローカルヘッダファイルやライブラリファイルを探すために必要な ’-I’ および ’-L’ フラグのリストです。これらはconfigure時の ’–with-local’ オプションにより設定されます。追加のローカルディレクトリは、’-I’、’-L’、’–incdirs’ ’–arcdirs’ の出力にも含まれます。

ファイルをインストールするためのパラメータ:

--prefix

configure時に設定されたディレクトリプレフィクス

--sysincdir

--siteincdir

--pkgincdir

それぞれ、システム/サイト/パッケージレベルの拡張モジュールヘッダファイルが インストールされるべきディレクトリ

--syslibdir

--sitelibdir

--pkglibdir

それぞれ、システム/サイト/パッケージのSchemeファイルがインストールされる べきディレクトリ

--sysarchdir

--sitearchdir

--pkgarchdir

それぞれ、システム/サイト/パッケージのDSOファイルがインストールされる べきディレクトリ

--mandir

--infodir

それぞれ、Gaucheのmanpageとinfoドキュメントがインストールされるべきディレクトリ

拡張モジュールをビルドするためのパラメータ:

--object-suffix

コンパイルされたオブジェクトファイルの拡張子 (例: ’o’ や ’obj’)

--executable-suffix

実行可能ファイルの拡張氏(ピリオドを含む)。Unixシステムでは空文字列、 Windowsでは ’.exe’。

--so-suffix

動的ロード(dlopen)可能なファイルの拡張子 (例: ’so’)

--so-cflags

動的ロード可能なファイルを作るために追加で必要なCFLAGS

--so-ldflags

動的ロード可能なファイルを作るために追加で必要なLDFLAGS

--so-libs

動的ロード可能なファイルを作るために追加で必要なライブラリ

--dylib-suffix

動的リンクされる (dlopenされるのではない) ライブラリファイルの拡張子。 通常は–so-suffixと同じだが、OSXでは ’dylib’。

--dylib-ldflags

動的リンクされるライブラリファイルを作るのに必要なLDFLAGS。

--rpath-flag

RPATHを埋め込むためのコンパイラフラグ

--default-cflags

Gaucheをコンパイルする時に使われたCFLAGS。拡張モジュールをコンパイルする時にも 同じフラグを使うべき。

--cppflags

Cプリプロセッサに渡されるコンパイラフラグ

--static-libs

Gaucheを静的リンクする時に必要なリンクフラグ (’-llib’) のリスト。 ’-l’ と似ているが、これは拡張モジュールが必要とするライブラリ、 及びGaucheの静的ライブラリ本体(’-lgauche-static-X.X’)を含んでいる。

--libgauche-so

動的リンクされるlibgaucheのbasename

3.7.2 gauche-package - 拡張パッケージの管理 ¶

Program: gauche-package command [arg …] ¶

This command can be used to build and install Gauche extensions, query installed ones, and help start building new ones. It has several subcommands, which can be listed with gauche-package help.

3.7.3 gauche-install - ファイルのインストール ¶

Program: gauche-install [options] file dest ¶

Program: gauche-install [options] file … dir ¶

Program: gauche-install -d [options] dir … ¶

Program: gauche-install -T dir [options] file … ¶

Program: gauche-install -U dir [options] file … ¶

This command can be used to install files. It is upper-compatible to BSD install command and can be used as drop-in replacement. Notably, the first three command invocation format are compatible with BSD install. It has several more features that keeps Makefile concise.

The first and second invocation format copies file(s) to dest (a file pathname) or dir (an existing directory). You can specify permissons, owners, etc. Basically it’s a fancier cp.

The third format creates dir(s) if they don’t exist. Basically it’s a fancier mkdir -p.

The fourth format copies file … to dir. It differs from the second format in the sense that relative pathname of file is preserved. That is, if you run the following command:

gauche-install -T /usr/local/mytool foo.scm bar/baz.scm

It creates /usr/local/mytool/foo.scm and /usr/local/mytool/bar/baz.scm. With the second format, the subdirectory bar won’t be created. This format is handy when you want to install a bunch of subtrees.

The fifth format uninstall files which would be installed with -T option. Simply change -T option to -U option and you’ll clean the files.

The following command-line arguments are recognized.

-C

--canonical-suffix

If installed file has a suffix .sci, replace it for .scm. This is Gauche specific convention.

-T dir

--target dir

Installs files to the dir, creating paths if needed. Partial path of files are preserved. (4th format only)

-U dir

--uninstall dir

Reverse the effect of -T, e.g. removes files from its destination dir.

-S dir

--srcdir dir

Look for file … within dir; useful if VPATH is used.

--shebang path

Adds #!path before the file contents. Useful to install scripts.

-d

--directory

Creates directories. (3rd format only).

-m mode

--mode mode

Change mode of the installed file.

-p prefix

--strip-prefix prefix

Strip prefix dirs from file … before installation. (4th/5th format only).

-o owner

--owner owner

Change owner of the installed file(s).

-g group

--group group

Change group of the installed file(s).

-v

--verbose

Work verbosely

-d

--dry-run

Just prints what actions are to be done, but won’t execute them.

3.7.4 gauche-compie-r7rs - スクリプトのコンパイル ¶

For Gauche-specific programs, we have tools/build-standalone Scheme script (see スタンドアロン実行可能ファイルの作成). We recommend that script, for it is more featureful.

The gauche-compile-r7rs and compile-r7rs script is provided so that you can invoke a ’Scheme compiler’ with a standardized manner. It may be handy if other tools (e.g. IDE) need to invoke a Scheme compiler as a subprocess.

This interface is defined in SRFI-138, which also suggests the name compile-r7rs. We only install gauche-compile-r7rs by default so that we won’t accidentally clobber other implementation’s program, but if you give --enable-shared-commands option to configure script, a symbolic link compile-r7rs is created.

Program: gauche-compile-r7rs [options] script.scm ¶

Program: compile-r7rs [options] script.scm ¶

Compile a Scheme source file script.scm and produce an executable binary. The compile-r7rs is only installed if Gauche is configured with --enable-shared-commands.

Note: SRFI-138 states that if the environment variable COMPILE_R7RS is defined, it is assumed to a pathname of another program and is executed instead of Gauche’s compile-r7rs. We think the feature is rather confusing than convenient, so we don’t support it. If you want to run alternative implementation’s compiler, there are more explicit means such as running it directly or change PATH.

The following command-line arguments are recognized.

-I path

-A path

Prepend or append path to the path list the referenced libraries are searched. These options can be specified multiple times.

-o outfile

Specifies output executable filename. When omitted, a.out (on POSIX systems) or a.exe (on Windows) are used.

-D feature-id

Adds feature-id to the list of feature identifiers. This is to switch code conditionally in the source with cond-expand. This option can be specified multiple times.

Note that this does not enable certain features. So you shouldn’t specify system-reserved feature identifiers (see プラットフォーム依存の機能). This is also different from -D option of tools/build-standalone.