システムプログラム（第9回）: Web CGI

                                       筑波大学 システム情報系 情報工学域
                                       新城 靖
                                       <yas@cs.tsukuba.ac.jp>

このページは、次の URL にあります。
http://www.coins.tsukuba.ac.jp/~syspro/2020/2020-06-24 /index.html
あるいは、次のページから手繰っていくこともできます。
http://www.coins.tsukuba.ac.jp/~syspro/2020/
http://www.coins.tsukuba.ac.jp/~yas/

捕捉

小さなプログラムの利用

API の理解を深めるために、小さなプログラムを書いて挙動を確かめるとよい。

   1:	/*
   2:	  ~yas/syspro/string/strcmp-null.c --
   3:	  Created on: 2006/06/10 19:23:08
   4:	*/
   5:	
   6:	#include <stdio.h>      /*printf()*/
   7:	#include <string.h>     /* strcmp() */
   8:	
   9:	int
  10:	main( int argc, char *argv[], char *envp[] )
  11:	{
  12:	        int x ;
  13:	
  14:	        x = strcmp(0,".html");
  15:	        printf("%d\n", x );
  16:	}

$ make strcmp-null 
cc     strcmp-null.c   -o strcmp-null
$ ./strcmp-null 
Segmentation fault: 11
$

今日の重要な話

Web サーバ側のプログラム

CGI
- 環境変数 REQUEST_METHOD, QUERY_STRING, CONTENT_LENGTH
- (クロスサイトスクリプティング攻撃の仕組みと攻撃への備え)
- (html_escape() の必要性)

CGIの考え方

Web サーバは、普通は、ファイルに保存された HTML データや画像データを読み込み、Web ブラウザに返する。 CGI (Common Gateway Interface) では、ファイルが読み込まれる代わりにプログラムが実行され、その実行結果がブラウザに返される。

Gateway とは、World Wide Web で使われている HTTP というプロトコルへの入り口という意味である。プログラムの実行結果は、普通は、HTML にすることが多いが、普通のテキストであることも画像データであることもある。

クライアント、Web サーバ、CGIによるプロセス、ファイル
図? CGIの仕組み

CGI の利用例。クライアントからパラメタを受け取り、プログラムを実行し、データを保存したり、クライアントに返す内容を変化させる。

検索エンジンで検索すべきキーワードを受け取る。
アクセス・カウンタの画像を作成する。
掲示板で記事内容を受け取り保存する。
買い物サイトで購入する物の識別子やクレジット・カードの番号を受け取る。

CGIの設定(Apache)

情報科学類には、２つのサーバ・プロセスが動作している。

www.coins.tsukuba.ac.jp、ポート番号 80: ~/public_html/htdocs/ 以下を公開、CGI可能
www.coins.tsukuba.ac.jp、ポート番号 443: ~/public_html/secure_htdocs/ 以下を公開、CGI可能、SSL対応(http: ではなく https:)

いずれのサーバも、 Apache HTTP Server を用いている。

CGI になるファイル名のパタンの例（設定により、これ以外も可能）。


/cgi-bin/name
/dir/name.cgi

cgi-hello.c

cgi-hello.c は、クライアントに HTML で hello. と返すCGI のプログラムである。

cgi-hello.cプログラム全体

   1:	/*
   2:	  cgi-hello.c --簡単な CGI のプログラム
   3:	  ~yas/syspro/www/cgi-hello.c
   4:	*/
   5:	
   6:	#include <stdlib.h>     /* exit() */
   7:	#include <stdio.h>      /* printf() */
   8:	
   9:	extern void print_header();
  10:	extern void print_content();
  11:	
  12:	int
  13:	main()
  14:	{
  15:	        print_header();
  16:	        print_content();
  17:	}
  18:	
  19:	void
  20:	print_header()
  21:	{
  22:	        printf("Content-Type: text/html\n");
  23:	        printf("\n");
  24:	}
  25:	
  26:	void
  27:	print_content()
  28:	{
  29:	        printf("<HTML><HEAD></HEAD><BODY>\n");
  30:	        printf("hello.\n");
  31:	        printf("</BODY></HTML>\n");
  32:	}

CGI のプログラムは、Apache の場合、標準ではHTTP のヘッダ(一番最初の「HTTP/1.0 200 OK」ではなく、２行目以降)を標準出力に出力する所から始まる。Content-Type: 行は、必ず付ける。空行がヘッダと本分の区切りである。ここまで行末は、\r\n ではなく \n でよい。本文には、この場合は、HTML の文書を出力している。

CGI の例題のプログラムを ~/public_html/以下に設置し、http:// や https:// でアクセスして実行する時には、Web サーバ(Linux)にログインしててからコンパイルしなさい。(iMac の macOS でコンパイルしたバイナリは、 Linux では動作しない。http:// や https:// でアクセスしないのであれば、 iMac macOS や自宅の PC でコンパイルして実行しても良い。)

$ ssh www.coins.tsukuba.ac.jp 
(プロンプトに含まれているホスト名が変化したことに注意する。)
$ mkdir ~/public_html/htdocs/syspro-cgi-examples 
$ cd ~/public_html/htdocs/syspro-cgi-examples 
$ cp ~yas/syspro/www/cgi-hello.c . 
$ cc cgi-hello.c -o cgi-hello.cgi 
$ ./cgi-hello.cgi  
Content-Type: text/html

<HTML><HEAD></HEAD><BODY>
hello.
</BODY></HTML>
$

CGI のプログラムの場合、拡張子を .cgi にする。 CGI のプログラムを、シェルから実行することもできる。引数の与え方については、後述する。

cgi-hello.cのWebブラウザからの実行

Web ブラウザでは、次の URL を開く。

http://www.coins.tsukuba.ac.jp/~ユーザ名/syspro-cgi-examples/cgi-hello.cgi

~/public_html/htdocs/ 以下の場合は、http:// 。 ~/public_html/secure_htdocs/ 以下の場合は、https:// 。 syspro-cgi-examples は、上の mkdir と合わせる。

telnet では、次のようにして実行する。

$ telnet www.coins.tsukuba.ac.jp 80 
Trying 130.158.231.114...
Connected to viola5.coins.tsukuba.ac.jp.
Escape character is '^]'.
GET /~ユーザ名/syspro-cgi-examples/cgi-hello.cgi HTTP/1.0
Host: www.coins.tsukuba.ac.jp

GET の代りに POST でもよい。

$ telnet www.coins.tsukuba.ac.jp 80 
Trying 130.158.231.114...
Connected to viola5.coins.tsukuba.ac.jp.
Escape character is '^]'.
POST /~ユーザ名/syspro-cgi-examples/cgi-hello.cgi HTTP/1.0
Host: www.coins.tsukuba.ac.jp
Content-Length: 0

この講義のページに設置された cgi-hello.cgi ( http://www.coins.tsukuba.ac.jp/~syspro/2020/2020-06-24/cgi-hello.cgi ) の実行例。

$ telnet www.coins.tsukuba.ac.jp 80 
Trying 2001:2f8:3a:1711::231:114...
Connected to www.coins.tsukuba.ac.jp.
Escape character is '^]'.
GET /~syspro/2020/2020-06-24/cgi-hello.cgi HTTP/1.0
Host: www.coins.tsukuba.ac.jp

HTTP/1.1 200 OK
Date: Mon, 17 Jun 2020 06:49:00 GMT
Server: Apache
Connection: close
Content-Type: text/html

<HTML><HEAD></HEAD><BODY>
hello.
</BODY></HTML>
Connection closed by foreign host.
$

POST の場合。

$ telnet www.coins.tsukuba.ac.jp 80 
Trying 2001:2f8:3a:1711::231:114...
Connected to www.coins.tsukuba.ac.jp.
Escape character is '^]'.
POST /~syspro/2020/2020-06-24/cgi-hello.cgi HTTP/1.0
Host: www.coins.tsukuba.ac.jp
Content-Length: 0

HTTP/1.1 200 OK
Date: Mon, 17 Jun 2020 06:53:27 GMT
Server: Apache
Content-Length: 48
Connection: close
Content-Type: text/html

<HTML><HEAD></HEAD><BODY>
hello.
</BODY></HTML>
Connection closed by foreign host.
$

CGIとフォーム

ブラウザからサーバに情報を送ってほしい時には、 HTML のフォーム(form)という機能を使う。

HTML記述例

<H2><A id="cgi-example-get">CGI の GET メソッドを使う例</A></H2>

<FORM ACTION="cgi-printarg.cgi" method="get">
    <P>
    姓: <INPUT type="text" name="lastname">
    名: <INPUT type="text" name="firstname"><BR>
    <INPUT type="radio" name="lang" value="C"> C言語 <BR>
    <INPUT type="radio" name="lang" value="Java"> Java言語 <BR>
    <INPUT type="radio" name="lang" value="others"> その他 <BR>
    電子メール: <INPUT type="text" name="email"><BR>
    <INPUT type="submit" value="send"> <INPUT type="reset">
    </P>
</FORM>

<H2><A id="cgi-example-post">CGI の POST メソッドを使う例</A></H2>

<FORM ACTION="cgi-printarg.cgi" method="post">
    <P>
    姓: <INPUT type="text" name="lastname">
    名: <INPUT type="text" name="firstname"><BR>
    <INPUT type="radio" name="lang" value="C"> C言語 <BR>
    <INPUT type="radio" name="lang" value="Java"> Java言語 <BR>
    <INPUT type="radio" name="lang" value="others"> その他 <BR>
    電子メール: <INPUT type="text" name="email"><BR>
    <INPUT type="submit" value="send"> <INPUT type="reset">
    </P>
</FORM>

表示例

CGI の GET メソッドを使う例

姓: 名:
C言語
Java言語
その他
電子メール:

CGI の POST メソッドを使う例

姓: 名:
C言語
Java言語
その他
電子メール:

<FORM>と</FORM>で括られた部分が１つのフォームになる。(１つのページに複数のフォームを置くことができる。)

<INPUT>の部分が、ブラウザからサーバに送られるデータを表わす。

「<INPUT type="submit">」のボタンが押されると、ブラウザは、指定されたメソッドを使ってサーバにデータを送る。

HTTPにより送られるデータの形式

method="get"の場合、Web ブラウザは、普通のファイルを指定する時と同じように、URL に含めて送る。

GET /~syspro/2020/2020-06-24/cgi-printarg.cgi?lastname=name1&firstname=name2&lang=C&email=who@dom HTTP/1.0←↓
Host: www.coins.tsukuba.ac.jp←↓
←↓

URL の長さの上限で制限されるので、長いデータは送れない。

メソッドとして POST が使われた時、Web ブラウザは、データをHTTP の本文(ヘッダではない部分、空行の後)に入れて送る。

POST /~syspro/2020/2020-06-24/cgi-printarg.cgi HTTP/1.0←↓
Host: www.coins.tsukuba.ac.jp←↓
Content-Length: 91←↓
←↓
lastname=name1&firstname=name2&lang=C&email=who@u-ust.ac.jp←↓

Web サーバからCGIプログラムへのパラメタの受け渡し

Web サーバは、HTTP で GET や POST により要求を受けとる。Web サーバは、 URL の部分を解析し、CGI として認識すると、指定されたプログラムを実行する。実行された CGI プログラムは、環境変数と標準入力からデータを受け取ることができる。

CGI で利用できる主な環境変数を以下に示す。

環境変数名内容

REQUEST_METHOD データを送るのに使われたメソッド。POST か GET。

QUERY_STRING URLの指定で「?」以下に指定された文字列。

SCRIPT_NAME プログラムの名前。

CONTENT_LENGTH POSTメソッドが使われた時、標準入力から読み込めるデータのバイト数

データは、「&」で区切られた「名前=値」の並びになっている。

環境変数名	内容
`REQUEST_METHOD`	データを送るのに使われたメソッド。POST か GET。
`QUERY_STRING`	URLの指定で「?」以下に指定された文字列。
`SCRIPT_NAME`	プログラムの名前。
`CONTENT_LENGTH`	POSTメソッドが使われた時、標準入力から読み込めるデータのバイト数

例:

lastname=name1&firstname=name2&lang=C&email=who@u-ust.ac.jp

GETメソッドが使われた場合、CGI のプログラムは、環境変数 QUERY_STRING からデータを得る。 POSTメソッドが使われた場合、CGI のプログラムは、データを標準入力から受け取る。データのバイト数は、環境変数CONTENT_LENGTH に指定されている。

送られてくるパラメタの中に漢字、「&」、「;」、その他 URLで使えない文字が含まれていた場合、「%hh( hh は2桁の16進数)」という形になっている。これをパーセント・エンコーディングという。たとえば、「&」は、「%26」として送られる。

これを元にもどすにはcgiparse というプログラム、 Ruby の CGI::unescape() や pack('H*')、 perl の命令 hex() が使われる。

cgi-printarg.c

次のプログラムは、CGI で実行された時に、その引数を表示するものである。 GET メソッド、および、POST メソッドの両方に対応している。なお、パラメタの区切りとしては、「&」が使われることを期待している。

シェルからのCGIプログラムの実行

CGI のプログラムをシェルから実行してデバッグすることもできる。

GET の場合、環境変数 REQUEST_METHOD に GETと設定し、環境変数 QUERY_STRING にパラメタを設定する。

$ cp ~yas/syspro/www/cgi-printarg.c . 
$ cc cgi-printarg.c -o cgi-printarg.cgi  
$ ./cgi-printarg.cgi 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
REQUEST_METHOD=(null)
SCRIPT_NAME=(null)
QUERY_STRING=(null)
CONTENT_LENGTH=(null)
query_string=(null)
No query string.
</PRE></BODY></HTML>
$ export REQUEST_METHOD=GET 
$ export QUERY_STRING='lastname=name1&firstname=name2&lang=C&email=who@dom' 
$ ./cgi-printarg.cgi 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
REQUEST_METHOD=GET
SCRIPT_NAME=(null)
QUERY_STRING=lastname=name1&amp;firstname=name2&amp;lang=C&amp;email=who@dom
CONTENT_LENGTH=(null)
query_string=lastname=name1&amp;firstname=name2&amp;lang=C&amp;email=who@dom
qv[0]: lastname=name1(lastname=name1)
qv[1]: firstname=name2(firstname=name2)
qv[2]: lang=C(lang=C)
qv[3]: email=who@dom(email=who@dom)
</PRE></BODY></HTML>
$

POST の場合、まず、データをファイルに保存しておく。そのバイト数を wc コマンドなどで調べておく。環境変数 REQUEST_METHOD に POST と設定する。環境変数 CONTENT_LENGTH にデータファイルの大きさを設定する(ここでは最後の改行を取り除いたバイト数を指定している)。

$ unset QUERY_STRING 
$ export REQUEST_METHOD=POST 
$ echo 'lastname=name1&firstname=name2&lang=C&email=who@dom' > data 
$ wc data  
 1  1 52 data
$ export CONTENT_LENGTH=51 
$ ./cgi-printarg.cgi < data 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
REQUEST_METHOD=POST
SCRIPT_NAME=(null)
QUERY_STRING=(null)
CONTENT_LENGTH=51
query_string=lastname=name1&amp;firstname=name2&amp;lang=C&amp;email=who@dom
qv[0]: lastname=name1(lastname=name1)
qv[1]: firstname=name2(firstname=name2)
qv[2]: lang=C(lang=C)
qv[3]: email=who@dom(email=who@dom)
</PRE></BODY></HTML>
$

cgi-printarg.cのmain()

   1:	
   2:	/*
   3:	  cgi-printarg.c -- CGI プログラムに対する引数を表示するプログラム
   4:	  ~yas/syspro/www/cgi-printarg.c
   5:	*/
   6:	
   7:	#include <stdlib.h>     /* getenv(), malloc() */
   8:	#include <stdio.h>      /* printf() */
   9:	#include <string.h>     /* strlen() */
  10:	#include <sys/types.h>  /* read() */
  11:	#include <sys/uio.h>    /* read() */
  12:	#include <unistd.h>     /* read() */
  13:	#include <ctype.h>      /* isdigit() */
  14:	
  15:	extern void  print_header(void);
  16:	extern void  print_content(void);
  17:	extern char *get_query_string();
  18:	extern char *read_query_string();
  19:	extern void  safe_printenv( char *name );
  20:	extern void  safe_print_string( char *str );
  21:	extern char *html_escape( char *str );
  22:	extern char *decode_url( char *str );
  23:	extern char *getparam( int qc, char *qv[], char *name );
  24:	
  25:	extern int string_split( char *str, char del, int *countp, char ***vecp  );
  26:	extern void free_string_vector( int qc, char **vec );
  27:	extern int countchr( char *s, char c );
  28:	
  29:	int
  30:	main()
  31:	{
  32:	        print_header();
  33:	        print_content();
  34:	}
  35:	
  36:	void
  37:	print_header()
  38:	{
  39:	        printf("Content-Type: text/html\n");
  40:	        printf("\n");
  41:	}
  42:	
  43:	void
  44:	print_content()
  45:	{
  46:	        char  *query_string ;
  47:	        int    qc ;
  48:	        char **qv ;
  49:	        int    i ;
  50:	
  51:	        printf("<HTML><HEAD></HEAD><BODY><PRE>\n");
  52:	
  53:	        safe_printenv("REQUEST_METHOD");
  54:	        safe_printenv("SCRIPT_NAME");
  55:	        safe_printenv("QUERY_STRING");
  56:	        safe_printenv("CONTENT_LENGTH");
  57:	
  58:	        query_string = get_query_string();
  59:	        printf("query_string=");
  60:	        safe_print_string( query_string ); printf("\n");
  61:	
  62:	        if( query_string == NULL )
  63:	        {
  64:	                printf("No query string.\n");
  65:	        }
  66:	        else if( string_split( query_string,'&',&qc, &qv ) < 0 )
  67:	        {
  68:	                printf("Error while parsing query string\n");
  69:	        }
  70:	        else
  71:	        {
  72:	                for( i=0 ; i<qc ; i++ )
  73:	                {
  74:	                        char *decoded ;
  75:	                        printf("qv[%d]: ",i);
  76:	                        safe_print_string(qv[i]);
  77:	                        decoded = decode_url( qv[i] );
  78:	                        printf("("); safe_print_string( decoded ); printf(")\n");
  79:	                        if( decoded )
  80:	                                free( decoded );
  81:	                }
  82:	                free_string_vector( qc, qv );
  83:	        }
  84:	
  85:	        printf("</PRE></BODY></HTML>\n");
  86:	        if( query_string )
  87:	                free( query_string );
  88:	}
  89:

これは、標準の CGI プログラムなので、print_header()では、HTTP のヘッダのうち、Content-Type: 行だけを出力している。

print_content() では、本文を出力している。

safe_printenv() で、環境変数 REQUEST_METHOD, SCRIPT_NAME, QUERY_STRING, CONTENT_LENGTH の内容を標準出力に出力している。

get_query_string() は、クライアントから送られてきたパラメタ(query string)を読込み、文字列として返す関数である。この結果を、 safe_print_string() で標準出力に出力している。

strint_split() で query string を区切り文字「&」で分解している。この関数は、練習問題(703) string_split()とfree_string_vector()の利用で使ったものと同じものである。分解した結果は、main() の引数である int argc, char *argv[] と同じ形になっている。qc が、argc, qv が argv に対応する。

for ループでは、qv[] をsafe_print_string() で標準出力に出力している。さらに、decode_url() で、%hh (%hhは16進数)の形式を、バイトに元に戻すものである。

free_string_vector() は、string_split() で malloc() したものを free() するための手続きである。

get_query_string()

get_query_string() は、CGI でプログラムが実行された時にパラメタが含まれた文字列を読み込むプログラムである。

  90:	char *
  91:	get_query_string()
  92:	{
  93:	        char *request_method, *query_string;
  94:	        request_method = getenv("REQUEST_METHOD");
  95:	        if( request_method == 0 )
  96:	                return( 0 );
  97:	        else if( strcmp(request_method,"GET") == 0 )
  98:	        {
  99:	                query_string = getenv("QUERY_STRING");
 100:	                if( query_string == 0 )
 101:	                        return( 0 );
 102:	                else
 103:	                        return( strdup(query_string) );
 104:	        }
 105:	        else if( strcmp(request_method,"POST") == 0 )
 106:	        {
 107:	                return( read_query_string() );
 108:	        }
 109:	        else
 110:	        {
 111:	                printf("Unknown method: ");
 112:	                safe_print_string( request_method );
 113:	                printf("\n");
 114:	                return( 0 );
 115:	        }
 116:	}
 117:

get_query_string() は、クライアントから送られてきたパラメタを、１つの文字列として受け取るものである。GET メソッドの場合()は、単に環境変数 REQUEST_METHOD を読めばよい。ただし、文字列の長さの上限がきつい。

strdup() は、文字列をコピーするものである。使い終わったら、free() で解放する。

POST メソッドの場合は、read_query_string() で続きの処理を行う。

read_query_string()

read_query_string() は、CGI でPOSTメソッドが使われた時にパラメタを標準入力から読み込む。

 118:	char *
 119:	read_query_string()
 120:	{
 121:	        int   clen ;
 122:	        char *content_length ;
 123:	        char *buf ;
 124:	
 125:	        content_length = getenv("CONTENT_LENGTH");
 126:	        if( content_length == 0 )
 127:	        {
 128:	                return( 0 );
 129:	        }
 130:	        else
 131:	        {
 132:	                clen = strtol( content_length,0,10 );
 133:	                buf = malloc( clen + 1 );
 134:	                if( buf == 0 )
 135:	                {
 136:	                        printf("read_query_string(): no memory\n");
 137:	                        exit( -1 );
 138:	                }
 139:	                if( read(0,buf,clen) != clen )
 140:	                {
 141:	                        printf("read error.\n");
 142:	                        exit( -1 );
 143:	                }
 144:	                buf[clen] = 0 ;
 145:	                return( buf );
 146:	        }
 147:	}
 148:

CONTENT_LENGTH には、10進数でバイト数が含まれている。

Webブラウザの表示例

REQUEST_METHOD=GET
SCRIPT_NAME=/~syspro/2020/2020-06-24/cgi-printarg.cgi
QUERY_STRING=lastname=name1&firstname=name2&lang=C&email=who%40dom
CONTENT_LENGTH=(null)
query_string=lastname=name1&firstname=name2&lang=C&email=who%40dom
qv[0]: lastname=name1(lastname=name1)
qv[1]: firstname=name2(firstname=name2)
qv[2]: lang=C(lang=C)
qv[3]: email=who%40dom(email=who@dom)

REQUEST_METHOD=POST
SCRIPT_NAME=/~syspro/2020/2020-06-24/cgi-printarg.cgi
QUERY_STRING=
CONTENT_LENGTH=53
query_string=lastname=name1&firstname=name2&lang=C&email=who%40dom
qv[0]: lastname=name1(lastname=name1)
qv[1]: firstname=name2(firstname=name2)
qv[2]: lang=C(lang=C)
qv[3]: email=who%40dom(email=who@dom)

cgi-printarg.cgiの内部関数

以下の内容は、飛ばしてよい。

html_escape()

safe_printenv() は、環境変数をgetenv() で検索し、その値を safe_print_string() で標準出力に出力している。

safe_print_string() は、html_escape() を使って文字列を安全なものにして表示する。

html_escape()(次回説明)は、クライアントから送られたような信頼できない文字列をクライアントに送り返す時に、不用意に JavaScript 等がクライアント側のブラウザで動作しないようにするための関数である。たとえば、<SCRIPT> のような文字列がクライアントから送られてきたとしても、クライアントには「<SCRIPT>」と返すだけで、スクリプトは実行されない。

decode_url()

decode_url() は、「%hh(2桁の16進数)」を元のバイトに戻すものである。isxdigit() は、１６進数の文字として正しいかを調べている。strtol() で基底を 16 として変換している。その他に、「'+'」を「' '」に変換している。

JavaによるCGIプログラムの作成(hello)

JavaによるCGIプログラムの作成(printarg)

Apacheの機能

アクセスログとエラーログ

Web サーバは、ページがアクセスされる度に記録を残す。この記録をアクセスログという。アクセスログは、情報科学類のサーバ www (www.coins.tsukuba.ac.jp) では、次の場所にある。

http: /var/log/httpd/access*
https: /var/log/httpd/ssl_access*

この中で、数字が一番大きなもの、または、日付が新しいものが、現在増加しているログである。

$ cd /var/log/httpd/ 
$ ls    access* | tail -1 
$ ls -t access* | head -1

以下の例では、現在増加しているログは access_log_20200621 である。

$ cd /var/log/httpd/ 
$ ls access*     | tail -1 
access_log_20200621
$ ls  -t access* | head  -1 
access_log_20200621
$

以下は、アクセス・ログの内容の例である。見やすいように改行を入れているが実際には１行が１つのページの転送を意味する。

2001:2f8:3a:1711::230:30 - - [22/Jun/2020:12:06:32 +0900] "GET /~syspro/2020/202
0-06-17/index.html HTTP/1.1" 200 38350 "http://www.coins.tsukuba.ac.jp/~syspro/2
020/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:77.0) Gecko/20100101 Fir
efox/77.0"

2001:2f8:3a:1711::230:30 - - [22/Jun/2020:12:06:32 +0900] "GET /~syspro/2020/202
0-06-17/images/tcpip-server-fork-1.png HTTP/1.1" 200 7204 "http://www.coins.tsuk
uba.ac.jp/~syspro/2020/2020-06-17/index.html" "Mozilla/5.0 (Macintosh; Intel Mac
 OS X 10.14; rv:77.0) Gecko/20100101 Firefox/77.0"

2001:2f8:3a:1711::230:30 - - [22/Jun/2020:12:21:35 +0900] "GET /~syspro/2020/202
0-06-24/cgi-printarg.cgi?lastname=name1&firstname=name2&lang=C&email=who%40dom H
TTP/1.1" 200 443 "http://www.coins.tsukuba.ac.jp/~syspro/2020/2020-06-24/index.h
tml" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:77.0) Gecko/20100101 Fire
fox/77.0"

2001:2f8:3a:1711::230:30 - - [22/Jun/2020:12:21:56 +0900] "POST /~syspro/2020/20
20-06-24/cgi-printarg.cgi HTTP/1.1" 200 375 "http://www.coins.tsukuba.ac.jp/~sys
pro/2020/2020-06-24/index.html" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; r
v:77.0) Gecko/20100101 Firefox/77.0"

このログは、設定ファイル /etc/httpd/conf/httpd.conf にある CustomLog 等の設定による。

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
CustomLog "|/usr/sbin/rotatelogs -l /etc/httpd/logs_http/access_log_%Y%m%d 20M" combined

combined という名前が付けられたログのフォーマットの意味は、以下の通りである。

%h: クライアントの IP アドレス。
%l: identd で調べたユーザ名。普通は、"-"
%u: 認証が行われた時のユーザ名。
%t: アクセスされた時刻
%r: 要求行(request line)
%>s: ステータス(200 OK なら 200)
%b: 応答のバイト数
%{Referer}i: Referer: 行の内容。リンク元をたどってアクセスされた時のリンクの元。
%{User-Agent}i" User-Agent: 行の内容。Web ブラウザの種類。

アクセスログの他に、エラーが起きた時にもログが作られる。これをエラーログという。エラーログは、情報科学類のサーバ www (www.coins.tsukuba.ac.jp) では、次の場所にある。

http: /var/log/httpd/error_log_*
https: /var/log/httpd/ssl_error_log_*

CGI のプログラムをデバッグする時には、このエラーログを見て原因を探る。

その他に、次のようなログを取ることもある。

ssl_request_log (coins では /var/log/httpd/ssl_request_log_*): SSL のプロトコル等
/var/log/httpd/suexec.log 等 (coins では /var/log/secure): suExec を使っていた時のログ

自分が単に Web ブラウザを使っているだけでも、さまざまな情報をサーバに送っているとに注意しなさい。

CGI プログラムを実行するプロセスの権限

シェルからプロセスを生成しプログラムを実行する時には、その新しいプロセスの権限（ユーザ属性、getuid() の結果）は、シェルのものからコピーされる。すなわち、新しいプロセスはシェルと同じユーザの権限で動作する。CGI の場合、遠隔の Web ブラウザのユーザは、その Web サーバにログインする権限はないが、CGI のプログラムを実行することができる。そのプログラムを、どのユーザの権限で実行する方法としては、大きく次の２つ方法がある。

Web サーバ・プロセスの権限で動作させる。
CGI プログラムを設置したユーザの権限で動作させる(suEXEC)。

どちらの方式にも一長一短がある。Web サーバ・プロセスの権限で動作させた場合、次のような長所と短所がある。

長所：万一、CGI プログラムにバグがあった場合でも、電子メールなど個人のファイルが保護される。
短所：CGIが利用するファイルを、Web サーバのプロセスからアクセスできる状態にしなければならない。通常の運用では、誰からでもアクセスできる状態にする必要がある(モードを 666 rw-rw-rw-や 777 rwxrwxrwx にする)。このため、そのコンピュータにログインでき人ならば、そのファイルの名前を知っていれば、データを取り出したり内容を破壊したりできる。

suEXEC を使う方法の場合、長所と短所は逆になる。

短所：万一、CGI プログラムにバグがあった場合、電子メールなど個人のファイルが盗まれる。
長所：CGIが利用するファイルを保護できる。CGI を設置した人だけがアクセスできるように設定できる(モードを 600 rw-------や 700 rwx------ にする)。

ステータス行も含むヘッダ(Apache non-parsed headers)

Apache では、標準では、サーバが最初のステータス行「HTTP/1.1 200 OK」を Apache が作成している。Status:という行を含めることで、ステータス行を記述することもできる。Status:がない場合、Location: というヘッダがあれば、302 Found (redirect)、それ以外の場合は、

200
OK

が返される。それ以外のヘッダも、Apache が自動的に生成して返す。

ステータス行も含めて、完全なヘッダを CGI で作成して返すこともできる。この方法を、Apache では、nph (non-parsed headers) と呼んでいる。

Apache で、nph を使うには、nph- で始まるファイル名を用いる。これを使うと、Apache は、CGI プログラムが作成したヘッダを一切解釈(parse) せず、そのままクライアントに返す。

CGIでのその他の注意事項

ファイルのロック

練習問題と課題

練習問題(901) ifconfigコマンドによるIPアドレスの調査(macOS,Unix系)

ifconfig コマンドは、Unix 系のオペレーティング・システムでネットワーク・インタフェース(interface)の設定を行う(configure)を行うコマンドである。ifconfig コマンドを利用すると、IP アドレスの設定を表示することができる。

ifconfig コマンドを使って実習室の自分が利用している iMac の IP アドレスを調べなさい。

$ ifconfig -a 
$ ifconfig en0

macOS の場合、en0 や en1 の項目の inet の次に IPv4 のIP アドレスが表示される。inet6 の次に、IPv6 の IPアドレスが表示される。IPv6 の IP アドレスは、複数表示されることが一般的である。IPv4 の IP アドレスは、1 個のことが多いが、複数表示されることもある。 (en0 や en1 の項目は、システムによって異なる。eth0 や eth1 のような名前のこともある。)

次の例では、IPv4 の IP アドレスは、inet に続く 130.158.230.30 である。IPv6 の IP アドレスは、inet6 に続く 2001:2f8:3a:1711::230:30,やfe80::1410:bd29:d2af:b6ae である。(実行するコンピュータによって、異なる。)

$ ifconfig en0
en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
        ether 38:f9:d3:02:71:66
        inet6 fe80::1410:bd29:d2af:b6ae%en0 prefixlen 64 secured scopeid 0x6
        inet6 2001:2f8:3a:1711::230:30 prefixlen 64
        inet 130.158.230.30 netmask 0xfffffe00 broadcast 130.158.231.255
        nd6 options=201<PERFORMNUD,DAD>
        media: autoselect
        status: active
$

次の例では、IPv6 のアドレスとして、多数の一時アドレス(temporary) が現れている。Web サーバをアクセスする時には、クライアントはプライバシ保護のためにこの一時アドレスを利用することがある。Web サーバのアクセスログを検索する時には、この一時アドレスも調べる必要がある。

$ ifconfig en0
en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
        options=10b<RXCSUM,TXCSUM,VLAN_HWTAGGING,AV>
        ether 68:5b:35:9b:51:f9
        inet6 fe80::1833:ea4f:2089:a339%en0 prefixlen 64 secured scopeid 0x5
        inet6 2001:2f8:3a:1711:182b:4524:1f08:7660 prefixlen 64 autoconf secured
        inet6 2001:2f8:3a:1711:91e2:c6f3:e3da:2f54 prefixlen 64 deprecated autoconf temporary
        inet 130.158.231.9 netmask 0xfffffe00 broadcast 130.158.231.255
        inet6 2001:2f8:3a:1711:59d9:d716:d9ba:df17 prefixlen 64 deprecated autoconf temporary
        inet6 2001:2f8:3a:1711:ed56:b02e:7a81:c9a2 prefixlen 64 deprecated autoconf temporary
        inet6 2001:2f8:3a:1711:6816:37bc:89b3:7d78 prefixlen 64 deprecated autoconf temporary
        inet6 2001:2f8:3a:1711:ad1c:ecea:66da:f5a0 prefixlen 64 deprecated autoconf temporary
        inet6 2001:2f8:3a:1711:f0ee:46a2:8efd:453c prefixlen 64 autoconf temporary
        nd6 options=201<PERFORMNUD,DAD>
        media: autoselect (1000baseT <full-duplex,flow-control,energy-efficient-ethernet>)
        status: active
$

ifconfig コマンドは、macOS だけでなく、Linux を含む Unix 系のオペレーティング・システムで利用できる。コマンドが見つからない時には、次のようにコマンドを絶対パス名で打ってみなさい。

$ /sbin/ifconfig -a

あるいは、man ifconfig でマニュアルを表示して、探しなさい。

練習問題(902) hostnameコマンド

hostname コマンドを使って、自分が使っているコンピュータの名前を調べなさい。

$ hostname 
aloe30.local
$

$ hostname 
viola5
$

hostname コマンドは、DNS で使う長いドメイン名を表示することもあるが、短い名前や、それとは関係ない名前を表示することもある。

練習問題(903) hostコマンド

host コマンドを使って、IPv4、および、IPv6 の IP アドレスを調べなさい。

$ host aloe30 
aloe30.coins.tsukuba.ac.jp has address 130.158.230.30
aloe30.coins.tsukuba.ac.jp has IPv6 address 2001:2f8:3a:1711::230:30
$ host www.coins.tsukuba.ac.jp 
www.coins.tsukuba.ac.jp is an alias for viola5.coins.tsukuba.ac.jp.
viola5.coins.tsukuba.ac.jp has address 130.158.231.114
viola5.coins.tsukuba.ac.jp has IPv6 address 2001:2f8:3a:1711::231:114
$

次のホストについて、IP アドレスを調べなさい。

自分が実習室でいつも利用しているコンピュータ(iMac)。たとえば、aloe30.coins.tsukuba.ac.jp。
www.coins.tsukuba.ac.jp
viola5.coins.tsukuba.ac.jp
idp.coins.tsukuba.ac.jp
検索サイト
その他

練習問題(904) Web サーバ上のデータの観察

次の手順で、Web サーバ上のデータの観察のアクセスログを観察しなさい。

ssh コマンドを使ったことがない人は、コンピュータリテラシの資料を参考にして、ssh の使い方を学びなさい。
練習問題 sshコマンドによる遠隔ログインで、サーバ www.coins.tsukuba.ac.jp に ssh でログインしなさい。 fingerprint を使って SSHにおけるホストの認証を行いなさい。
Fingerprint が、 coinsシステムの主なSSHサーバの公開鍵のハッシュ値と一致していることを確認してから yes と打つこと。偽物のホストに接続してパスワードを打ってはならない。
```
aloe30:~ s1754321$ ssh www
The authenticity of host 'www (2001:2f8:3a:1711::231:114)' can't be established.
ECDSA key fingerprint is SHA256:PwCxoyGybzg/5ahMZamq0vCzn+6WPgpsyPZxPfr9E6k.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'www,2001:2f8:3a:1711::231:114' (ECDSA) to the list of known hosts.
s1754321@www's password:
Last failed login: Mon Jun 17 17:04:02 JST 2020 from aloe30.coins.tsukuba.ac.jp on ssh:notty
Last login: Mon Jun 17 16:03:54 2020 from 2001:2f8:3a:2300::1:8657
viola5:~ s1754321$ 
```
ssh で遠隔ログインする前後に、プロンプトのホスト名の部分が変化することに注意しなさい。(この例では、aloe30 から viola5 に変化している。)
サーバ www.coins.tsukuba.ac.jp 上の /var/www/htdocs/ 以下のファイルを観察しなさい。
```
$ cd /var/www/htdocs/ 
$ ls 
＜省略＞
$ cat index.html 
＜省略＞
```

同様に、/var/www/secure_htdocs/ 以下のファイルを観察しなさい。

$ cd /var/www/secure_htdocs/ 
$ ls 
＜省略＞
$ cat index.html 
cat: index.html: そのようなファイルやディレクトリはありません
$ cat index.php 
＜省略＞

練習問題(905) アクセスログの観察

情報科学類のWebサーバのアクセスログは、Webサーバ(www,www.coins.tsukuba.ac.jp)上の /var/log/httpd/access* というファイルにためられる。これを、次のコマンドを利用しながら観察しなさい。

lv コマンド、または、less コマンド
grep コマンド、または、egrep コマンド
tail コマンド

具体的な方法を以下に示す。

練習問題 Web サーバ上のデータの観察と同様に、ssh コマンドで www.coins.tsukuba.ac.jp にログインする。 Fingerprint を必ず確認すること。
cd コマンドで、ログがあるディレクトリに移動する。 (hostname の結果が viola5 でない時には、 ssh コマンドで www.coins.tsukuba.ac.jp にログインすること。)
```
$ hostname 
viola5
$ cd /var/log/httpd/ 
$ pwd 
/var/log/httpd
$ 
```
このディレクトリで、ls コマンドを実行しなさい。以下の例で、 access* の「*」は、シェルのファイル名置換の意味である。
```
$ ls 
（多くのファイルが表示される）
$ ls access* 
（まだ多くのファイルが表示される）
$ ls access*    | tail -1 
access_log_20200621
$ ls -t access* | head -1 
access_log_20200621
$ 
```
この例では、access_log_20200621 が最新のものである。
このファイルを lv コマンドで表示しなさい(スペースキー、bキー、qキーで操作)。
```
$ lv access上のlsの結果で置き換える 
```
たとえば、上の例では、次のように打つ。
```
$ lv access_log_20200621 
```

このファイルを、tail コマンドで表示しなさい。

$ tail access上のlsの結果で置き換える 
(表示がなされる。)
(しばらく待つ。)
$ tail access上のlsの結果で置き換える 
(表示がなされる。)
(しばらく待つ。)
$ tail access上のlsの結果で置き換える 
(表示がなされる。)

（しばらく間隔を空けてから）数回 tail コマンドを実行すると、その度に行が増えているはずである。たとえば、上の例では、次のように打つ。

$ tail access_log_20200621 
$ tail access_log_20200621 
$ tail access_log_20200621

Webサーバ・アクセスログを参考にして、アクセスログの意味を解釈しなさい。

練習問題(906) 学類 Web サーバのアクセス・ログの観察(grep)

自分自身で、情報科学類の Web ページをアクセスした時に、自分が使っている iMac の IP アドレスが表示されることを確認しなさい。

まず、Web ブラウザを実行しているコンピュータのの IP アドレスを調べなさい。自宅のコンピュータでは、NAT (Network Address Translation) の仕組みが動作していることがある。この場合は、この講義の「https://www.coins.tsukuba.ac.jp/~syspro/2020/report/present.cgi,出席ボタン」を押すと、そこに表示されるので、それを利用する方法がある。 (出席ボタンは、何度押しても問題がない。授業時間外に押しても問題はない。最終的に、授業時間内のものだけ集計される。) NAT を利用していないコンピュータ(実習室のコンピュータ含む)では、練習問題 ifconfigコマンドで調べる方法がある。
次のように grep コマンドを使って、IP アドレスを検索しなさい。
```
$ grep IPアドレス アクセスログのファイル名 
```
たとえば、IP アドレスが 2001:2f8:3a:1711::230:30 であれば、次のように打つ。
```
$ grep 2001:2f8:3a:1711::230:30 アクセスログのファイル名 
```
たとえば、IP アドレスが 130.158.230.30 であれば、次のように打つ。
```
$ grep 130.158.230.30 アクセスログのファイル名 
```
ここで「アクセスログのファイル名」は、練習問題アクセスログの観察で調べなさい。たとえば、その練習問題の例では、次のように打つ。
```
$ grep 2001:2f8:3a:1711::230:30 access_log_20200621 
```

もし、何も現れなければ、この講義の Web ページをアクセスした後で、アクセスログを検索してみなさい。

練習問題(907) 学類 Web サーバのアクセス・ログの観察(tail-f)

ログのファイルを tail -f で表示してみなさい。

$ tail -f アクセスログのファイル名

ここで「アクセスログのファイル名」は、練習問題学類 Web サーバのアクセス・ログの観察で調べなさい。たとえば、その練習問題の例では、次のように打つ。

$ tail -f access_log_20200621

-f オプションを指定すると、tail コマンドは終了することなく新しく追加された行を表示する。この tail コマンドは、自動的には終了しないので、終わったら、 ^C (Control+C) で強制終了させる。

練習問題(908) 学類 Web サーバのアクセス・ログの観察(https)

情報科学類では、2つの World Wide Web のサーバを実行している。

http://www.coins.tsukuba.ac.jp/ 。SSL を用いていない。
https://www.coins.tsukuba.ac.jp/ 。SSL を用いている。

練習問題(905) では、SSL を用いていない学類 Web サーバ (http:のもの) のアクセス・ログの観察していた。それと同様に、と同様に、 SSL を用いているサーバ (https: のもの)について、アクセスログを観察しなさい。

ssh コマンド www.coins.tsukuba.ac.jp にログインする(httpと同じ)。
cd コマンドで、ログがあるディレクトリに移動する(httpと同じ)。
```
$ cd /var/log/httpd/ 
```

このディレクトリで、次のような名前のファイルを探す(httpと異なる)。

ssl_access*

$ ls 
（多くのファイルが表示される）
$ ls ssl_access* 
（まだ多くのファイルが表示される）
$ ls ssl_access*    | tail -1 
（１つだけ表示される）
$ ls -t ssl_access* | head -1 
（１つだけ表示される）
$

tail コマンド、lv コマンド、grep コマンド等で表示する(httpと同じ)。

練習問題(909) cgi-arg1arg2.cgi

次の CGI プログラムをコマンドラインから実行しなさい。

~yas/syspro/www/cgi-arg1arg2.c

$ cp ~yas/syspro/www/cgi-arg1arg2.c . 
$ cc cgi-arg1arg2.c -o cgi-arg1arg2.cgi  
$ ./cgi-arg1arg2.cgi  
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
Error while parsing query string
</PRE></BODY></HTML>
$ export REQUEST_METHOD=GET 
$ export QUERY_STRING='arg1=10&arg2=20' 
$ ./cgi-arg1arg2.cgi  
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
arg1: [10]
arg2: [20]
</PRE></BODY></HTML>
$

次のようにパラメタを設定して実行してみなさい。

arg1 と arg2 の両方を設定
arg1 のみを設定
arg2 のみを設定
arg1 も arg2 も設定しない

余裕があれば、REQUEST_METHOD=POST についても、同様に実行してみなさい。

余裕があれば、フォームを定義し、何かデータを送ってみなさい。 coins で CGI を実行する場合、CGI の実行形式を Web サーバ (http://www.coins.tsukuba.ac.jp) に ssh でログインした上で作成すること。 iMac macOS で作成した実行形式は、Web サーバ Linux では動作しない。

http://www.coins.tsukuba.ac.jp/~syspro/2020/2020-06-24/cgi-arg1arg2.cgi

たとえば、次のような記述を含む HTML ファイルを作成し、 ~/public_html/htdocs/ 以下に置く。

<FORM ACTION="http://www.coins.tsukuba.ac.jp/~syspro/2020/2020-06-24/cgi-arg1arg2.cgi" method="get">
    arg1: <INPUT type="text" name="arg1">
    arg2: <INPUT type="text" name="arg2">
    <INPUT type="submit">
    <INPUT type="reset">
</FORM>

arg1: arg2:

また、余裕があれば、method="post" についても同様に行ってみなさい。

練習問題(910) CGIによる足算

この課題を解く前に必ず練習問題(909) を行なうことを強く奨める。

２つのデータを受け取り、その結果を加えた数を表示するようなCGI のプログラムを作成しなさい。

ヒント：

"arg1=10&arg2=20"のように送るようなフォームを想定してプログラムを作成する。
cgi-arg1arg2.cgiで、余計な表示をなくす。
string_split() で分解した後、"arg1=" や "arg2=" があるパラメタを検索する。
```
     char *arg1_s,*arg2_s;
     arg1_s = getparam(qc,qv,"arg1");
     arg2_s = getparam(qc,qv,"arg2");
```
getparam() は、次のような関数であり、 cgi-arg1arg2.cgiのソースコードに含まれている。

char *getparam(int qc, char *qv[], char * varname ) [独自]
第１引数と第2引数は、 string_split() で作成したカウントと文字列のベクタである。第3引数が"name"の時、この関数は、 "name=value" というパラメタを見つけ、"value"を返す。見つからなかったら NULL を返す。この関数の使い方は、ライブラリ関数 getenv() と似ているので、それも参考にしなさい。
引数が足りかったり、不正な場合にはエラー・メッセージを表示して終了する。ただし、"arg1=100xxx" のように、数の後ろに数字ではないものが含まれていたとしても、それを無視してよいものとする。
得られた文字列を、strtol() 等で整数に変換し、足算を行う。結果を printf() の %d などで表示する。
作成したプログラムを、シェルから実行して動作を確認する。
```
$ export REQUEST_METHOD=GET 
$ export QUERY_STRING='arg1=10&arg2=20' 
$ ./a.out 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY>
30
</BODY></HTML>
$ 
```
なお、一度設定した環境変数の値は、シェルを終了するまで残っている。 a.out を実行するたびに設定する必要はない。
レポートには、引数が足りかったり、不正な場合にはエラー・メッセージを表示して終了することも示しなさい。

練習問題(911) CGIによる足算(coins Web サーバへの設置)

練習問題 CGIによる足算を coins の Web サーバ http://www.coins.tsukuba.ac.jp で CGI として動作させなさい。まず、CGI の実行形式を Web サーバに ssh でログインした上で作成すること。 iMac macOS で作成した実行形式は、Web サーバ Linux では動作しない。

実行形式(以下の例では a.out) を　~/public_html/htdocs の下にコピーする。例:

$ cc cgi-add.c 
$ mkdir ~/public_html/htdocs/syspro-cgi-examples 
$ cp a.out ~/public_html/htdocs/syspro-cgi-examples/calc.cgi

Web ブラウザで次のような URL を開く。例:

$ open 'http://www.coins.tsukuba.ac.jp/~ログイン名/syspro-cgi-examples/calc.cgi?arg1=10&arg2=20'

"arg1=10&arg2=20"のように送るようなフォームを含むHTML ファイルを作成する。例:
```
$ emacs ~/public_html/htdocs/syspro-cgi-examples/calc.html 
```
Web ブラウザでフォームを含む　HTML ファイルを開き、実行する。例:
```
$ open http://www.coins.tsukuba.ac.jp/~ログイン名/syspro-cgi-examples/calc.html 
```

練習問題(912) CGIによる加減乗除

練習問題(910) で、足算以外の計算もできるようにしなさい。演算の種類は、メニューやラジオボタンなどで選択できるようにしなさい。この課題では、Web ブラウザで実行して、その結果とその時のアクセスログを示しなさい。

練習問題(913) CGIによるカレンダの表示

fork() と execve() を使って、/usr/bin/cal を実行し、Web ブラウザに今月のカレンダを実行する CGI プログラムを作りなさい。cal コマンドは、引数を付けずに実行すると、今月のカレンダーを表示する。

$ cal 
      June 2020
Su Mo Tu We Th Fr Sa
    1  2  3  4  5  6
 7  8  9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30
$

CGI プログラムを実行した月のカレンダーを表示しなさい。固定した表示するだけなら、CGI の意味はない。余計な表示は省略すること。

ヘッダや HTML の一部を表示する。fflush() で、それらをWeb サーバに送る。
fork(), execve(), wait() 等を用いて、cal コマンドを実行する。標準出力をそのままにしておけば cal コマンドの結果がそのまま CGI の結果として返される。その他に、pipe() を用いて結果を受け取る方法も考えられる。この課題では、system() や popen() を用いてはならない。
wait() 等で子プロセスの終了を確認したら、残りの HTML を出力する。

作成したプログラムを、シェルから実行して動作を確認する。

$ ./a.out 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
      June 2020
Su Mo Tu We Th Fr Sa
    1  2  3  4  5  6
 7  8  9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30

</PRE></BODY></HTML>
$

そのプログラムを CGI として動作させなさい。

~/public_html/htdocs の下にコピーする。

$ mkdir ~/public_html/htdocs/syspro-cgi-examples 
$ cp a.out ~/public_html/htdocs/syspro-cgi-examples/show-cal-one.cgi

Web ブラウザから次のようなURLを開き、CGI を実行する。

$ open http://www.coins.tsukuba.ac.jp/~ログイン名/syspro-cgi-examples/calc-one.cgi

CGI のプログラムを実行するようなフォームを含むHTML ファイルを作成する。

<FORM ACTION="http://www.coins.tsukuba.ac.jp/~ログイン名/syspro-cgi-examples/calc-one.cgi" method="get">
<INPUT type="submit">
</FORM>

Web ブラウザからフォームを含む HTML ファイルを開き、CGI を実行する。

練習問題(914) CGIによるカレンダの表示(引数付き)

練習問題(913) で、今月のカレンダーではなく、任意の年・月のカレンダーを表示しなさい。cal コマンドは、次のように引数を与えて実行すると、任意の年月のカレンダーを表示する機能がある。

$ cal 8 2020 
     August 2020
Su Mo Tu We Th Fr Sa
                   1
 2  3  4  5  6  7  8
 9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31
$

この機能を利用して、Web ブラウザから送られた年月のカレンダーを表示する CGI プログラムを作成しなさい。

"year=2020&month=8"のように送るようなフォームを想定してプログラムを作成する。
cgi-arg1arg2.cgiで、余計な表示をなくす。
string_split() で分解した後、"year=" や "month=" があるパラメタを検索する。
```
     char *year_s,*month_s;
     year_s = getparam(qc,qv,"year");
     month_s = getparam(qc,qv,"month");
```
getparam() は、 cgi-arg1arg2.cgiのソースコードに含まれている。
引数が足りかったり、不正な場合にはエラーメッセージを表示して終了する。
得られた文字列を、strtol() 等で整数に変換する。引数の範囲をチェックする。たとえば、13月や-1年, 10000年等が与えられた場合には、エラーメッセージを表示して終了する。
snprintf() 等で、cal コマンドにあたえる引数を文字列で作る。一度、整数としてチェックした結果から cal コマンドに与える引数を作成すると安全である。
ヘッダや HTML の一部を表示する。fflush() で、それらをWeb サーバに送る。
fork(), execve(), wait() 等を用いて、cal コマンドを実行する。標準出力をそのままにしておけば cal コマンドの結果がそのまま CGI の結果として返される。その他に、pipe() を用いて結果を受け取る方法も考えられる。この課題では、system() や popen() を用いてはならない。
wait() 等で子プロセスの終了を確認したら、残りの HTML を出力する。
作成したプログラムを、シェルから実行して動作を確認する。
```
$ export REQUEST_METHOD=GET 
$ export QUERY_STRING='year=2020&month=8' 
$ ./a.out 
Content-Type: text/html

<HTML><HEAD></HEAD><BODY><PRE>
     August 2020
Su Mo Tu We Th Fr Sa
                   1
 2  3  4  5  6  7  8
 9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31
</PRE></BODY></HTML>
$ 
```
なお、一度設定した環境変数の値は、シェルを終了するまで残っている。 a.out を実行するたびに設定する必要はない。
レポートには、次の結果を含めなさい。
- 期待されたデータを与えた時、正しい結果を出力する。
- 引数が足りかったり、不正な場合にはエラー・メッセージを表示する。

そのプログラムを CGI として動作させなさい。

~/public_html/htdocs の下にコピーする。

$ mkdir ~/public_html/htdocs/syspro-cgi-examples 
$ cp a.out ~/public_html/htdocs/syspro-cgi-examples/show-cal.cgi

Web ブラウザから次のようなURLを開き、CGI を実行する。

$ open 'http://www.coins.tsukuba.ac.jp/~ログイン名/syspro-cgi-examples/calc.cgi?year=2020&month=8'

"year=2020&month=8"のように送るようなフォームを含むHTML ファイルを作成する。
Web ブラウザからフォームを含む HTML ファイルを開き、CGI を実行する。

この課題では、フォームを含む HTML ファイルを作成し、 CGIとして実行し、その結果をレポート含めなさい。その結果としては、アクセスログを含めなさい。

注意: CGI のパラメタは、最初は、文字列で受け取り、最終的に cal コマンドには文字列で渡す。この時に、年月日としては不適切なものがクライアントから渡される可能性がある。不適切なものが渡された場合には、エラー・メッセージを表示しなさい。また、不正なパラメタで cal コマンドは実行しないようにしなさい。

練習問題(915) CGIプログラムの実行権限

CGI プログラムが、どのユーザの権限で動作しているかを調べるプログラムをつくりなさい。CGI として実行した時とシェルから実行した時の結果を比較しなさい。

ヒント：CGI のプログラムから getuid(), getgid(), getgroups() システム・コールを実行する。uid や gid を文字列で表示したいなら、getpwuid(), getpwuid_r(), getgrgid(), getgrgid_r() を用いる。

getuid(), getgid(), getgroups() システム・コールを用いる代わりにid コマンド、whoami コマンド、groups コマンド等を実行する方法もある。

練習問題(916) 文字列を表示するアクセス・カウンタ

アクセスされる度に、数字が増えるようなページをCGI で作成しなさい。よく使われるアクセス・カウンタは、HTML にインライン・イメージとして埋め込まれる。この課題で作成するカウンタは、単体のページとして動作し、テキストを表示するものである。

ヒント：

次のようなプログラムを作成する。

main()
{
	ファイルから整数を読み出す（ファイルがなければ0とする）。
	1 加える。
	標準出力(画面)に整数値を表示する。
	ファイルに整数を保存する。
}

上のプログラムに、CGI として動作するようにヘッダを付ける。 Content-Type: は、text/plain にする。 Content-Type: を text/html にする方法もある。ただし、本文は、HTML として作成する必要がある。
最終的にそのプログラムが ~/public_html/htdocs 以下にコピーされることを想定して、整数を保存するファイルを修正する。必要ならば、初期状態のファイルを作成して、環境に合わせてモードを適切なものにする(常に chmod 666 は誤り)。
拡張子を .cgi として、~/public_html/htdocs 以下にコピーする。
Web ブラウザから URL を指定して実行する。

練習問題(917) 文字列を表示するアクセス・カウンタ(ロック付き)

練習問題(916) で、ファイルに対するロックを行うようにしないさい。

ロックがきちんと動作していることを示しなさい。そのためには、ロックして getchar() 等でキーボードからの指示で(アンロックして)終了するプログラムを作成する方法がある。プログラムが終了すると自動的にアンロックされる。次のプログラムを参考にしてもよい。

~yas/syspro/file/lock-fcntl-sh.c
~yas/syspro/file/lockf-sh.c
~yas/syspro/file/flock-sh.c

注意: 2019年4月-2023年3月、coins の環境では、www サーバからNFS経由でアクセスしているファイルに対して次のどの方法でもロックが働く。

fcntl(,F_SETLKW,)
lockf()
flock()

他の環境では、NFS経由でのロックがうまく働かないこともあるので、使う前に確認すること。2009年2月までの環境では、flock() や fcntl() が動作しなかった。

練習問題(918) ハッシュ表を使うライブラリ関数

メモリ中のハッシュ表を使うライブラリ関数 hcreate(), hsearch(), hdestroy() について調べなさい。

練習問題(919) 永続的ハッシュ表

永続的なハッシュ表とは、メモリ中のハッシュ表と同様に、キーを指定して値をアクセスするための機能を提供するが、データはファイルに保存されているので、次に同じプログラムを実行した時も、そのまま残されている所が異なる。具体的な内部のアルゴリズムとしては、ハッシュの他にＢ木もよく使われる。一般的なデータベースの場合、いくつかの制約(integrity rule)を満たすことが重要となるが、永続的ハッシュ表の場合には、特にそのような制約はない。

永続的なハッシュ表を作成する方法として、dbm ライブラリを用いる方法がある。これを利用してみなさい。ライブラリ関数としては、dbm_open(), dbm_store(), dbm_fetch(), dbm_delete(), dbm_close()がある。詳しくは、 man dbm_open を見なさい。

Java 言語の場合、dbm ライブラリではなく、その他の埋め込み型の key-value store を使ってもよい。

練習問題(920) 文字列を表示するアクセス・カウンタ(永続的ハッシュ表の利用)

練習問題(916) で、データを通常のファイルではなく、永続的ハッシュ表を用いるようにしなさい。

練習問題(921) アキュームレータ

練習問題(916) では、アクセスされる度に 1 ずつ増える。そうではなくて、引数をとり、その数を増やしていくようなものを作成しなさい。

Webブラウザから１つの引数（整数）を受け取る。 CGI のプログラムを実行するようなフォームを含むHTML ファイルを作成する。
Web ブラウザからフォームを含む HTML ファイルを開き、CGI を実行する。
引数がない、または、不正な引数が与えられれば、エラー・メッセージと現在の値を表示する。
正当な引数があれば、保存されている現在の値を引数に加え、保存する。さらに、新しい値を表示する。

練習問題(922) アキュームレータ(ロック付き)

練習問題(921) で、練習問題(917) と同様に、ファイルに対するロックを行うようにしないさい。

この課題では、ロックが働いていることを示すために、CGI のプログラムとは別にファイルのロックだけを行なうプログラムを作成しなさい。そして、次のようなことを行いなさい。

シェルからロックだけを行なうプログラム実行し、ファイルをロックする。
CGI のプログラムを実行する。シェルから実行しても、Web から実行してもどちらでも良い。 CGI のプログラムが固まることを確認する。
1. のプログラムを終了して、ロックを解除する。
2. の CGI のプログラムが実行が再開される。

この結果を、レポートに書きなさい。

Last updated: 2020/06/22 21:31:53

Yasushi Shinjo / <yas@cs.tsukuba.ac.jp>