ptclear.c File Reference

ポートを用いたメッセージと待機中プロセスを解放する。 More...

#include <xinu.h>

Include dependency graph for ptclear.c:

Go to the source code of this file.

Functions
void	_ptclear (struct ptentry *ptptr, uint16 newstate, int32(*dispose)(int32))
	ポートを用いたメッセージと待機中プロセスを解放する。 More...

Detailed Description

ポートを用いたメッセージと待機中プロセスを解放する。

Definition in file ptclear.c.

Function Documentation

_ptclear()

void _ptclear	(	struct ptentry *	ptptr,
		uint16	newstate,
		int32(*)(int32)	dispose
	)

ポートを用いたメッセージと待機中プロセスを解放する。

Step1. ポートの状態をLIMBOとし、他のプロセスからポート使用不可とする。
Step2. ポートシーケンス番号をリセットする。
Step3. メッセージリストが空になるまで、各メッセージを処分する。
Step4. メッセージリスト全体をフリーリストとする。
Step5. 引数で指定されたポートクリア後の状態に応じて、処理を切り替える。
　・PT_ALLOCの場合：ポートテーブルエントリの先頭と末尾をNULLを指す状態とし、送受信用セマフォをリセットする。
　・上記以外の場合：送受信用セマフォを削除する。
Step6. ポート状態を引数で指定された状態に変更する。

Parameters

[in]	ptptr	クリア対象のポートテーブルエントリ
[in]	newstate	ポートをクリアした後の新しい状態
[in]	dispose	メッセージ処分用の関数ポインタ

Note

ポート内部の関数をクリアまたはリセットするために、ptdeleteおよびreset経由で_ptclear()は使用される。
_ptclear()の呼び出しは、割り込みが無効であり、引数の有効性がチェックされている事を前提としている。

Definition at line 24 of file ptclear.c.

References NULL, PT_ALLOC, PT_LIMBO, ptfree, ptentry::pthead, ptentry::ptmaxcnt, ptnode::ptmsg, ptnode::ptnext, ptentry::ptrsem, ptentry::ptseq, ptentry::ptssem, ptentry::ptstate, ptentry::pttail, semdelete(), and semreset().

Referenced by ptdelete(), and ptreset().

{
    struct ptnode *walk; /* Pointer to walk message list    */

    /* Place port in limbo state while waiting processes are freed */

    ptptr->ptstate = PT_LIMBO;

    ptptr->ptseq++;       /* Reset accession number */
    walk = ptptr->pthead; /* First item on msg list */

    if (walk != NULL)
    { /* If message list nonempty   */

        /* Walk message list and dispose of each message */

        for (; walk != NULL; walk = walk->ptnext)
        {
            (*dispose)(walk->ptmsg);
        }

        /* Link entire message list into the free list */

        (ptptr->pttail)->ptnext = ptfree;
        ptfree = ptptr->pthead;
    }

    if (newstate == PT_ALLOC)
    {
        ptptr->pttail = ptptr->pthead = NULL;
        semreset(ptptr->ptssem, ptptr->ptmaxcnt);
        semreset(ptptr->ptrsem, 0);
    }
    else
    {
        semdelete(ptptr->ptssem);
        semdelete(ptptr->ptrsem);
    }
    ptptr->ptstate = newstate;
    return;
}

Here is the call graph for this function:

Here is the caller graph for this function: