C言語でのソケットエラーの検出：perror()とstrerror()を使った実践ガイド

ソケットエラーはネットワーク通信において非常に頻繁に発生する問題で、接続の確立、データの送受信、切断といったプロセスのさまざまな段階で起こり得ます。その原因は、ネットワーク障害、接続タイムアウト、リソースの制限、設定ミスなど多岐にわたります。

本記事では、C言語において「perror()」関数と「strerror()」関数を使ってソケットエラーを検出・捕捉する2つのアプローチについて、実際のサンプルコードを交えながら詳しく解説します。

ソケットエラーとは？

C言語におけるソケットエラーは、主にソケット関数が返す負の戻り値や特定のエラーコードによって識別されます。これらのエラーコードは、エラーの性質に関する貴重な情報を提供してくれるため、問題の検出と解決に大いに役立ちます。ソケット関数が負の値を返した場合、それは実行中に何らかのエラーが発生したことを意味します。たとえば、「socket()」関数がソケットの作成に失敗すると、失敗を示す負の値が返されます。この戻り値をチェックするだけで、エラーを簡単に検出し、適切に対処することができます。

さらに、ソケット関数は「errno」という変数にも値を設定します。「errno」は、直近のシステムコールやライブラリ関数の呼び出しに関連する具体的なエラーコードを格納するグローバル変数です。「<errno.h>」ヘッダーファイルをインクルードすることでアクセスでき、エラーの原因に関する追加情報を示す定義済みのエラーコードが含まれています。戻り値とエラーコードの意味を正しく理解すれば、エラーの発生源を特定し、適切なアクションを取れるようになります。

サンプルコード1：perror()関数でソケットエラーを捕捉する

#include <stdio.h>
#include <stdlib.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <unistd.h>

int main()
{
    int socketDescriptor;
    struct sockaddr_in serverAddress;

    // ソケットを作成
    socketDescriptor = socket(AF_INET, SOCK_STREAM, 0);
    if (socketDescriptor < 0) {
        perror("Socket creation failed");
        exit(EXIT_FAILURE);
    }

    // サーバーアドレスを設定
    serverAddress.sin_family = AF_INET;
    // 例としてポート番号を指定
    serverAddress.sin_port = htons(7070);
    // ローカルIPアドレス
    serverAddress.sin_addr.s_addr = inet_addr("127.0.0.1");

    // サーバーに接続
    if (connect(socketDescriptor, (struct sockaddr *)&serverAddress, sizeof(serverAddress)) < 0) {
        perror("Connection failed");
        exit(EXIT_FAILURE);
    }

    // データの送受信処理

    // ソケットを閉じる
    close(socketDescriptor);

    return 0;
}

実行結果：

$ gcc err.c -o err
$ ./err
Connection failed: Connection refused

解説：

このサンプルコードでは、まず「socket()」関数でソケットを作成しています。戻り値のソケットディスクリプタが0未満の場合は、ソケット作成時にエラーが発生したことを意味するため、「perror()」関数で対応するエラーメッセージを表示してプログラムを終了します。次にサーバーアドレスを設定し、「connect()」関数で接続を試みます。ここでも戻り値が0未満かどうかを確認し、接続に失敗した場合には再び「perror()」関数でエラーメッセージを表示してプログラムを終了させます。

「perror()」は、引数として渡した文字列に続けて、現在の「errno」に対応するエラーメッセージを標準エラー出力へ自動的に表示してくれる便利な関数です。この手法を使えば、C言語のソケットプログラミングで発生したエラーを簡単に捕捉し、ユーザーにとって有益なエラーメッセージを表示した上で、プログラムを適切に終了させることができます。

サンプルコード2：strerror()関数でソケットエラーを捕捉する

#include <stdio.h>
#include <stdlib.h>
#include <sys/socket.h>
#include <string.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <errno.h>
#include <unistd.h>

int main()
{
    int socketDescriptor;
    struct sockaddr_in serverAddress;

    // ソケットを作成
    socketDescriptor = socket(AF_INET, SOCK_STREAM, 0);
    if (socketDescriptor < 0) {
        fprintf(stderr, "Failed to create socket: %s\n", strerror(errno));
        exit(EXIT_FAILURE);
    }

    // サーバーアドレスを設定
    serverAddress.sin_family = AF_INET;
    // 例としてポート番号を指定
    serverAddress.sin_port = htons(7070);
    // ローカルIPアドレス
    serverAddress.sin_addr.s_addr = inet_addr("127.0.0.1");

    // サーバーへの接続を試みる
    if (connect(socketDescriptor, (struct sockaddr *)&serverAddress, sizeof(serverAddress)) < 0) {
        fprintf(stderr, "Failed to connect: %s\n", strerror(errno));
        exit(EXIT_FAILURE);
    }

    // データの送受信処理

    // ソケットを閉じる
    if (close(socketDescriptor) < 0) {
        fprintf(stderr, "Socket closure failed: %s\n", strerror(errno));
        exit(EXIT_FAILURE);
    }

    printf("Socket closed successfully.\n");
    return 0;
}

実行結果：

$ gcc error.c -o error
$ ./error
Failed to connect: Connection refused

解説：

このサンプルコードでは、「strerror()」関数を使ってC言語のソケットエラーを捕捉しています。「strerror()」関数を使うと、「errno」変数に格納されたエラーコードを、人間が読める形式のエラーメッセージに変換できます。「<string.h>」ヘッダーファイルをインクルードすることで「strerror()」関数が利用可能になり、そこに「errno」の値を渡すことで対応するエラーメッセージを取得できます。

このプログラムでは、ソケットを作成した後、ソケットディスクリプタが0未満かどうか（＝失敗かどうか）をチェックします。エラーが発生した場合は、「strerror()」関数に「errno」の値を渡してエラーメッセージを取得し、「fprintf()」関数で標準エラー出力に表示します。最後に、プログラムは失敗ステータスで終了します。なお、この例ではソケットを閉じる「close()」関数の戻り値までチェックしており、より堅牢なエラーハンドリングを実現している点が特徴です。

まとめ

ソケット関数が返す戻り値とエラーコードを理解することで、C言語におけるソケットエラーを簡単に捕捉し、適切に処理できるようになります。1つ目のサンプルコードでは「perror()」関数を使ったシンプルなエラー表示の方法を、2つ目のサンプルコードでは「strerror()」関数を使ってより詳細なエラーメッセージを取得する方法を紹介しました。これらの手法をマスターすれば、ソケットプログラミングにおいて有益なエラーメッセージを表示し、プログラムを適切に終了させることができるようになります。

著者について

Bamdeb Ghosh

Bamdeb Ghoshは、ワイヤレスネットワーク分野で豊富な実務経験を持つエンジニアです。Wiresharkを用いた無線・有線ネットワークのパケットキャプチャ解析のスペシャリストであり、Android、Bluetooth、Linuxコマンド、Pythonにも精通しています。彼のサイト：wifisharks.com