PostgreSQL/開発/include/utils/palloc.h のバックアップ(No.2)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• PostgreSQL/開発/include/utils/palloc.h へ行く。
  • 1 (2017-05-16 (火) 21:40:21)
  • 2 (2017-05-16 (火) 22:14:41)
  • 3 (2017-05-18 (木) 00:00:43)
  • 4 (2017-05-18 (木) 22:50:59)
  • 5 (2017-05-20 (土) 01:06:24)
  • 6 (2017-05-20 (土) 10:21:14)
  • 7 (2017-05-20 (土) 23:18:19)
  • 8 (2017-05-21 (日) 10:40:03)
  • 9 (2017-05-21 (日) 22:20:16)
  • 10 (2018-02-04 (日) 22:32:14)
  • 11 (2020-01-03 (金) 08:55:02)

---

PostgreSQL/開発

概要 †

• メモリ操作のためのAPI
• メモリはchunkと呼ばれる塊単位で扱われ，context（chunkを管理）に紐づくようになっている
• contextは木構造で管理されており，上位のcontextを破棄することで，下位のcontextの領域もまとめて解放することができる

定義 †

マクロ †

MemoryContextAllocExtendedのフラグ †

列挙型 †

構造体 †

MemoryContextCallback †

MemoryContext †

MemoryContextDataポインタの別名

// 引数1：アロケーションサイズ
palloc0fast(sz)

 参考  struct MemoryContextData - on doxygen.postgresql.org

関数 †

MemoryContextAlloc †

typedef struct MemoryContextData *MemoryContext;

MemoryContextAllocZero †

// 引数1：アロケーション対象のコンテキスト
// 引数2：割当てサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *MemoryContextAlloc(MemoryContext context, Size size);

MemoryContextAllocZeroAligned †

void memory_sample()
{
    // 専用のコンテキストを作成
    MemoryContext context = AllocSetContextCreate(CurrentMemoryContext,
                                                   "mycontext",
                                                   0,
                                                   8 * 1024,
                                                   8 * 1024);
    MemoryContext oldcontext = NULL;

    // カレントコンテキストのスイッチ
    oldcontext = MemoryContextSwitchTo(context);

    // メモリチャンクが返される
    MyExtensionOptions *opt = (MyExtensionOptions*) MemoryContextAlloc(context,
                                                                       sizeof(MyExtensionOptions));
    // pallocは，内部でCurrentMemoryContextを使う
    // MyExtensionOptions *opt  = (MyExtensionOptions*)palloc(sizeof(MyExtensionOptions));
    opt->optcontext = ForeignTableRelationId;
    opt->optname = pstrdup("option1");

    MemoryContextSwitchTo(oldcontext);
    MemoryContextDelete(context);
}

MemoryContextAllocExtended †

// 引数1：アロケーション対象のコンテキスト
// 引数2：アロケーションサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *MemoryContextAllocZero(MemoryContext context, Size size);

palloc †

// 引数1：アロケーション対象のコンテキスト
// 引数2：アロケーションサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *MemoryContextAllocZeroAligned(MemoryContext context, Size size);

palloc0 †

// 引数1：アロケーション対象のコンテキスト
// 引数2：アロケーションサイズ（byte）
// 引数3：メモリアロケーション動作を決めるフラグ
// 戻り値：メモリチャンクのポインタ
extern void *MemoryContextAllocExtended(MemoryContext context, Size size, int flags);

palloc_extended †

typedef struct MyExtensionOptions {
    const char *optname;
    Oid optcontext;
} MyExtensionOptions;

void memory_sample()
{
    MemoryContext context = AllocSetContextCreate(CurrentMemoryContext,
                                                   "mycontext",
                                                   0,
                                                   8 * 1024,
                                                   8 * 1024);
    MemoryContext oldcontext = NULL;

    oldcontext = MemoryContextSwitchTo(context);

    // 0クリア and メモリ確保失敗時にエラー報告
    MyExtensionOptions *opt = (MyExtensionOptions*) MemoryContextAllocExtended(context,
                                                                               sizeof(MyExtensionOptions),
                                                                               MCXT_ALLOC_ZERO | MCXT_ALLOC_NO_OOM);

    opt->optcontext = ForeignTableRelationId;
    opt->optname = pstrdup("option1");

    MemoryContextSwitchTo(oldcontext);
    MemoryContextDelete(context);
}

repalloc †

// 引数1：アロケーションサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *palloc(Size size);

pfree †

MyExtensionOptions *opt  = (MyExtensionOptions*)palloc(sizeof(MyExtensionOptions));
// 以下と同様である
// MyExtensionOptions  * opt = MemoryContextAlloc(CurrentMemoryContext, sizeof(MyExtensionOptions));

MemoryContextAllocHuge †

// 引数1：アロケーションサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *palloc0(Size size);

repalloc_huge †

// 引数1：アロケーションサイズ（byte）
// 引数2：メモリアロケーション動作を決めるフラグ
// 戻り値：メモリチャンクのポインタ
extern void *palloc_extended(Size size, int flags);

MemoryContextSwitchTo †

// 引数1：メモリチャンクのポインタ
// 引数2：再割り当てするサイズ（byte）
// 戻り値：新しいメモリチャンクのポインタ
extern void *repalloc(void *pointer, Size size);

MemoryContextRegisterResetCallback †

char *optname = palloc(1 << 4);
strcpy(optname, "hello world");
char *newoptname = repalloc(optname, 1 << 5);
strcpy(newoptname, "hello world, hello postgres");

MemoryContextStrdup †

// 引数1：メモリチャンクのポインタ
extern void pfree(void *pointer);

pstrdup †

// 引数1：アロケーション対象のコンテキスト
// 引数2：アロケーションサイズ（byte）
// 戻り値：メモリチャンクのポインタ
extern void *MemoryContextAllocHuge(MemoryContext context, Size size);

pnstrdup †

// 引数1：メモリチャンクのポインタ
// 引数2：再割り当てするサイズ（byte）
// 戻り値：新しいメモリチャンクのポインタ
extern void *repalloc_huge(void *pointer, Size size);

psprintf †

// 引数1：スイッチするメモリコンテキスト
// 戻り値：古い（スイッチする前の）メモリコンテキスト
MemoryContext MemoryContextSwitchTo(MemoryContext context)

pvsnprintf †

void memory_sample()
{
    MemoryContext context = AllocSetContextCreate(CurrentMemoryContext,
                                                   "mycontext",
                                                   0,
                                                   8 * 1024,
                                                   8 * 1024);
    MemoryContext oldcontext = MemoryContextSwitchTo(context);

    StringInfo strinfo = makeStringInfo();
    appendStringInfo(strinfo, "%s", "hoge");
    elog(NOTICE, "%s", strinfo->data);

    MemoryContextSwitchTo(oldcontext);
    MemoryContextDelete(context);
}

サンプルプログラム †

// 引数1：対象のメモリコンテキスト
// 引数2：reset/delete時に呼ばれるコールバック関数
extern void MemoryContextRegisterResetCallback(MemoryContext context, MemoryContextCallback *cb);

参考・関連 †

• palloc.h - on doxygen.postgresql.org
• memnodes.h - on doxygen.postgresql.org
• mcxt.c - on doxygen.postgresql.org

コメント †

お名前: