OpenXM/src/asir-doc/parts/risa.texi - diff

Return to risa.texi CVS log

Up to [local] / OpenXM / src / asir-doc / parts

Diff for /OpenXM/src/asir-doc/parts/risa.texi between version 1.6 and 1.10

version 1.6, 2000/01/20 03:00:34

version 1.10, 2001/03/16 05:18:05

Line 1

@comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.5 2000/01/20 01:44:33 noro Exp $

@comment $OpenXM: OpenXM/src/asir-doc/parts/risa.texi,v 1.9 2000/08/23 04:29:12 noro Exp $

@node Risa/Asir,,, Top

@chapter Risa/Asir

Line 6

\BJP

* Risa $B$*$h$S(B Asir::

* Asir $B$NFCD'(B::

* $B%$%s%9%H%l!<%7%g%s(B::

* Installation::

* $B%3%^%s%I%i%$%s%*%W%7%g%s(B::

* $B4D6-JQ?t(B::

* $B5/F0$+$i=*N;$^$G(B::

Line 51 The structure of @b{Risa} is as follows.

@item

\JP @code{$B4pK\1i;;It(B}

\EG @b{The basic algebraic engine}

\BJP

$B$3$l$O(B, @b{Risa} $B$NFbIt7A<0$KJQ49$5$l$?%*%V%8%'%/%H(B ($B?t(B, $BB?9`<0$J$I(B)

$B$N4V$N1i;;$r<B9T$9$kItJ,$G$"$j(B, UNIX $B$N(B @samp{libc.a} $B$J$I$HF1MM$N(B, $B%i%$%V%i(B

Line 75 language interface of @b{Risa}.

@item

\JP @code{$B%a%b%j4IM}It(B}

\EG @b{Memory Manager}

\BJP

@b{Risa} $B$G$O(B, $B%a%b%j4IM}It$H$7$F(B, @code{[Boehm,Weiser]} $B$K$h$k%U%j!<(B

$B%=%U%H%&%'%"(B (@code{gc-5.0alpha2}) $B$rMQ$$$F$$$k(B. $B$3$l$O%,!<%Y%8%3%l%/%7%g%s(B

Line 96 manager.

@item

@b{Asir}

\BJP

@b{Asir} $B$O(B, @b{Risa} $B$N7W;;%(%s%8%s$N8@8l%$%s%?%U%'!<%9$G(B

$B$"$k(B. @b{Risa} $B$G$O(B, $BHf3SE*MF0W$K%f!<%6MQ$N8@8l%$%s%?%U%'!<%9$r:n$k(B

Line 209 Distributed computation over UNIX

@end itemize

\BJP

@node $B%$%s%9%H%l!<%7%g%s(B,,, Risa/Asir

@section $B%$%s%9%H%l!<%7%g%s(B

\BEG

@node Installation,,, Risa/Asir

@section Installation

\JP $B0J2<$N<jB3$-$GITL@$JE@(B, $BITET9g$JE@$,$"$C$?>l9g$NLd$$9g$o$;$O(B

\BEG

Any questions and any comments on this manual are well come by e-mails

Any questions and any comments on this manual are welcome by e-mails

to the following address.

@example

noryo@@flab.fujitsu.co.jp

risa-admin@@sec.flab.fujitsu.co.jp

@end example

@noindent

\JP $B08$K(B e-mail $B$G$*4j$$$7$^$9(B.

@menu

\BJP

* UNIX binary version::

* UNIX $BHG(B::

* UNIX source code version::

* Windows $BHG(B::

\BEG

* UNIX version::

* Windows version::

@end menu

\BJP

@node UNIX binary version,,, Installation

@node UNIX $BHG(B,,, $B%$%s%9%H%l!<%7%g%s(B

@subsection UNIX binary version

@subsection UNIX $BHG(B

\BEG

@node UNIX version,,, Installation

@subsection UNIX version

@noindent

\BJP

$BI,MW$J%U%!%$%k$O(B @samp{asir.tgz} $B$G$"$k(B.

$B%?!<%2%C%H(B CPU/OS $B$KBP1~$9$k(B @samp{asir.tgz} $B$,I,MW$G$"$k(B.

$B$3$l$i$OA4$F(B @code{gzip} $B$G05=L$7$F$"$k$N$G(B, $BF~<j8e(B @code{gzip} $B$G(B

$BE83+$9$k(B. $B$^$:(B, $B%$%s%9%H!<%k$9$k%G%#%l%/%H%j$r7h$a$k(B. $B%G%U%)%k%H$G$O(B

@samp{/usr/local/lib} $B$K(B @samp{asir} $B$H$$$&%G%#%l%/%H%j$H$7$F(B

Line 261 flab.fujitsu.co.jp

Line 244 flab.fujitsu.co.jp

$B%G%#%l%/%H%j$H8F$V(B.

\BEG

A file @samp{asir.tgz} suitable for the taget machine/architecture

A file @samp{asir.tgz} suitable for the target machine/architecture

is required. After getting it,

you have to unpack it by @code{gzip}. First of all, determine

a derectory where binaries and library files are installed.

Line 314 the user's search path.

Line 297 the user's search path.

@end example

@noindent

\JP $B$3$N>uBV$G(B @samp{asir} $B$r5/F0$7$F$_$k(B.

\JP $B$3$l$G(B @samp{asir} $B$,5/F0$G$-$k(B.

\BEG

Start @samp{asir}, and @b{Asir} will immediately terminate leaving you

Then you can start @samp{asir}.

a message as follows.

@example

% /usr/local/bin/asir

asir_key not found.

This is Risa/Asir, Version 20000821.

You need a key for each machine on which you want to run Asir.

In order to get the key, send an e-mail consisting of the following

[0]

single line to risa@@sec.flab.fujitsu.co.jp.

ASIR XXXXXXXX

After a while, an e-mail will be returned containing only one line like

YYYYYYYY YYYYYYYY YYYYYYYY

Create '/export/home/noro/ca/Kobe/OpenXM/lib/asir/asir_key'

if necessary and append the returned string to the file.

@end example

@noindent

@node UNIX source code version,,, Installation

\BJP

@subsection UNIX source code version

$B$9$k$H(B, $B$3$N$h$&$J%a%C%;!<%8$,=P$F(B @samp{asir} $B$O=*N;$9$k(B. UNIX $BHG(B

$B$G$O(B, $B%^%7%s$4$H$K(B @code{key} $B$H8F$P$l$kJ8;zNs$,I,MW$G$"$k(B.

@code{key} $B$rF~<j$9$k$?$a$K$O(B,

@example

risa@@sec.flab.fujitsu.co.jp

@end example

$B08$K(B,

@example

ASIR XXXXXXXX

@end example

$B$H$$$&(B 1 $B9T$N$_$+$i$J$k(B e-mail $B$rAw$l$P$h$$(B. @code{XXXXXXXX} $B$OI=<($5$l$?(B

@code{ID} $B$G$"$k(B. $B@^$jJV$7(B

@example

YYYYYYYY YYYYYYYY YYYYYYYY

@end example

@noindent

$B$H$$$&7A$N(B 1 $B9T$N$_$+$i$J$k(B e-mail $B$,FO$/$N$G(B, $B$3$N(B 1 $B9T$r4^$`(B @samp{asir_key}

$B$J$k%U%!%$%k$r%+%l%s%H%G%#%l%/%H%j$K:n$C$F(B @samp{asir} $B$r5/F0$7$F$_$k(B.

\BEG

For UNIX version of @b{Asir}, you need a @code{key}, a string,

First of all you have to install PARI library. The following is

for each machine you want to run @b{Asir}.

a sample of installation of PARI on FreeBSD.

In order to get the @code{key}, you just need to send an e-mail

consisting of a single line like

@example

ASIR XXXXXXXX

@end example

to address

@example

risa@@sec.flab.fujitsu.co.jp

@end example

@noindent

Here, @code{XXXXXXXX} is the machine ID notified in the first message

from @b{Asir}.

After a while, an e-mail will be returned containing only one line like

@example

YYYYYYYY YYYYYYYY YYYYYYYY

@end example

@noindent

Then, you shall create a new file in the current directory

named @samp{asir_key} containing the returned string in one line.

All after this, call again @samp{asir}.

\BJP

$B$^$:(B PARI $B%i%$%V%i%j$r(B install $B$9$kI,MW$,$"$k(B. $B0J2<$O(B FreeBSD $B>e$G$N(B

PARI $B$N(B installation $B$NNc$G$"$k(B.

@example

% /usr/local/bin/asir

% su

This is Risa/Asir, Version 991227.

# gzip -dc pari-2.0.17.beta.tgz | tar xf -

# cd pari-2.0.17.beta

# ./Configure

[0]

# make install

# make install-lib-sta

@end example

@noindent

\BJP

$B$3$N$h$&$J%W%m%s%W%H$,=P$l$P(B, $BF~<j$7$?(B @code{key} $B$O$=$N%^%7%s$KBP$7$FM-8z(B

@samp{asir2000-src.tgz} $B$rF~<j8e(B, $BE,Ev$J%G%#%l%/%H%j(B

$B$G$"$k(B. @code{key} $B$r=q$$$F$*$/%U%!%$%k$K4X$7$F$O(B, $B4D6-JQ?t(B @code{ASIR_KEY}

$B$K$*$$$F(B, @code{gzip} $B$GE83+$7(B, $B0J2<$N<j=g$G(B install $B$9$k(B.

$B$N@bL@$N9`$G>\$7$/=R$Y$k$,(B, $B%i%$%V%i%j%G%#%l%/%H%j$K$3$3$G:n@.$7$?(B

$B%U%!%$%k(B @samp{asir_key} $B$rCV$1$P(B, $B$=$N%^%7%s>e$GA4$F$N%f!<%6$,(B @samp{asir}

$B$r;HMQ$G$-$k$h$&$K$J$k(B. @samp{asir_key} $B$K$OJ#?t$N%^%7%s$KBP$9$k(B @code{key}

$B$r=q$1$k$N$G(B, $B%i%$%V%i%j%G%#%l%/%H%j$r6&M-$7$F$$$k>l9g$G$b(B @samp{asir_key}

$B$K9T$rDI2C$7$F$$$1$P$h$$(B.

\BEG

If you get such a prompt (@samp{[0]}) from @b{Asir},

After getting @samp{asir2000-src.tgz}, unpack it by @code{gzip}

the key you have is valid to the machine you are currently running

and install necessary files as follows.

@code{asir}.

When the file @samp{asir_key} is located on the library directory,

all the users of the machine can execute @samp{asir}.

The file @samp{asir_key} can contain several lines for

several @code{key}'s.

This enables users to run several machines sharing the same library

directory by simply adding lines for machines to be used.

We shall describe about the file for @code{key}'s in detail in

@ref{Environment variable}.

@example

# cp asir_key /usr/local/lib/asir

% gzip -dc asir.tgz | tar xf -

% cd asir2000

% ./configure -oxhome /usr/local -pari -plot

% xmkmf -a

% make

% su

# make install

# make install-lib

# make install-doc

@end example

\BJP

@node Windows $BHG(B,,, $B%$%s%9%H%l!<%7%g%s(B

$B>e$NNc$G(B, @samp{/usr/local} $B$O%U%!%$%k$,(B install $B$5$l$k%G%#%l%/%H%j$r(B

@subsection Windows $BHG(B

$BI=$9(B. $BB($A(B, $B%P%$%J%j%U%!%$%k(B @samp{asir} $B$O(B @samp{/usr/local/bin}

$B$K(B install $B$5$l(B, $B%i%$%V%i%j$*$h$SJ8=q%U%!%$%k$O(B @samp{/usr/local/lib}

$B$K(B install $B$5$l$k(B. @code{-oxhome} $B$N0z?t$H$7$F;XDj$5$l$k%G%#%l%/%H%j(B

$B$O(B, PARI $B$N(B install $B@h$b$=$3$G$"$k$3$H$r0UL#$9$k(B. $B$b$7(B @b{Asir} $B$,(B

install $B$5$l$k%G%#%l%/%H%j$rJQ99$9$k>l9g(B, @samp{include/Risa.tmpl}

$B$N(B, $BJQ?t(B @code{PARIINC} $B$*$h$S(B @code{PARILIB} $B$NCM$rE,59JQ99$9$k(B

$BI,MW$,$"$k(B.

\BEG

In the above example, @samp{/usr/local} indicates the destination of the

installation. That is, the binary file @samp{asir} is installed in

@samp{/usr/local/bin} and the library and documentation files are

installed in @samp{/usr/local/lib}. The directory name specified as an

argument of @code{-oxhome} also indicates that PARI files are installed

in that directory. If you change the destination directory, you have to

modify the values of @code{PARIINC} and @code{PARILIB} in

@samp{include/Risa.tmpl} appropriately.

@node Windows version,,, Installation

@subsection Windows version

@noindent

\BJP

Line 610 Note that the setting takes effect after rebooting the

Line 541 Note that the setting takes effect after rebooting the

@itemize @bullet

@item

@code{ASIR_KEY}

\BJP

UNIX $BHG$G$O(B, @b{Asir} $B$,5/F0$5$l$?%^%7%s$KBP$9$k(B @code{key} $B$,$J$1(B

$B$l$P$=$N%^%7%s>e$G(B @b{Asir} $B$OF0:n$7$J$$(B. @code{key} $B$O(B 16 $B?J(B 8

Line 666 if environment @code{ASIR_LIBDIR} is not set.)

Line 597 if environment @code{ASIR_LIBDIR} is not set.)

@item

@code{ASIR_LIBDIR}

\BJP

@b{Asir} $B$N%i%$%V%i%j%G%#%l%/%H%j(B, $B$9$J$o$A%f!<%68@8l$G=q$+$l$?%U%!%$%k(B

$B$J$I$,$*$+$l$k%G%#%l%/%H%j(B. $B;XDj$,$J$$>l9g(B UNIX $BHG$G$O(B

Line 684 are installed on a private directory of the user.

Line 615 are installed on a private directory of the user.

@item

@code{ASIRLOADPATH}

\BJP

$B%m!<%I$5$l$k%U%!%$%k$,$"$k%G%#%l%/%H%j$r(B UNIX $B$N>l9g(B ':',

Windows$B$N>l9g(B ';' $B$G6h@Z$C$FJB$Y$k(B. $B%G%#%l(B

Line 703 the library directory will be searched.

Line 634 the library directory will be searched.

@item

@code{HOME}

\BJP

@var{-norc} $B%*%W%7%g%s$D$-$G5/F0$7$J$$>l9g(B, @samp{$HOME/.asirrc}$B$,$"$l$P(B,

$BM=$a$3$N%U%!%$%k$r<B9T$9$k(B. @code{HOME} $B$,@_Dj$5$l$F$$$J$$>l9g(B, UNIX $BHG(B

Line 836 value of the function.

Line 767 value of the function.

@noindent

\BJP

$B7W;;$r<B9TCf$K3d$j9~$_$r$+$1$?$$>l9g(B, $B3d$j9~$_%-%c%i%/%?(B($BDL>o$O(B

@kbd{C-c}, DOS $BHG$G$O(B @kbd{C-x}, Mac $BHG$G$O(B

@kbd{C-c}, Windows, DOS $BHG$G$O(B @kbd{C-x} $B$rF~NO$9$k(B.

@code{command+}@samp{.} ) $B$rF~NO$9$k(B.

\BEG

To interrupt the @b{Asir} execution, input an interrupt character

from the keyboard. A @kbd{C-c} is usually used for it.

(Notice: @kbd{C-x} for DOS version; @code{command+}@samp{.} for Macintosh

(Notice: @kbd{C-x} on Windows and DOS.)

version.)

@example

Line 948 like normal errors.

Line 877 like normal errors.

@table @code

@item SEGV

@itemx BUS ERROR

\BJP

$BAH$_9~$_H!?t$K$h$C$F$O(B, $B0z?t$N7?$r87L)$K%A%'%C%/$;$:$K1i;;%k!<%A%s$K0z(B

$B$-EO$7$F$7$^$&$b$N$bB8:_$7$F$$$k(B. $B$3$N$h$&$J>u67$K$*$$$F(B,

Line 964 is detected.

Line 893 is detected.

@item BROKEN PIPE

\BJP

$B%W%m%;%94VDL?.$K$*$$$F(B, $BAj<j@h$N%W%m%;%9$H$N4V$N%9%H%j!<%`(B

$B$,4{$KB8:_$7$F$$$J$$>l9g(B ($BNc$($P4{$KAj<j@h$N%W%m%;%9$,=*N;$7$F$$$k>l9g$J$I(B)

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>