نام (NAME)

memusage - پروفایل‌سازی و بررسی مصرف حافظه یک برنامه

خلاصه دستور (SYNOPSIS)

memusage [گزینه‌ها]... برنامه [گزینه‌های‌برنامه]...

توضیحات (DESCRIPTION)

دستور memusage یک اسکریپت بش (bash) است که مصرف حافظه یک برنامه مشخص‌شده توسط program را پروفایل‌سازی و بررسی می‌کند. این اسکریپت کتابخانه libmemusage.so را در محیط فراخواننده از طریق متغیر محیطی LD_PRELOAD (به ld.so(8) مراجعه کنید) از پیش بارگذاری می‌کند. کتابخانه libmemusage.so تخصیص حافظه را با رهگیری فراخوانی‌های توابع malloc(3)، calloc(3)، free(3) و realloc(3) ردیابی می‌کند؛ همچنین به‌صورت اختیاری، فراخوانی‌های توابع mmap(2)، mremap(2) و munmap(2) نیز می‌توانند رهگیری شوند.

دستور memusage می‌تواند داده‌های جمع‌آوری‌شده را به شکل متنی چاپ کند، یا می‌تواند با استفاده از memusagestat(1) (گزینه -p در ادامه را ببینید) یک فایل گرافیکی PNG شامل نمایش نموداری از داده‌های جمع‌آوری‌شده ایجاد نماید.

گزینه‌ها (OPTIONS)

-n name, --progname=name

نام فایل برنامه‌ای که باید پروفایل‌سازی شود.

-p file, --png=file

تولید تصویر گرافیکی PNG و ذخیره آن در file.

-d file, --data=file

تولید فایل داده‌های باینری و ذخیره آن در file.

-u, --unbuffered

عدم بافر کردن خروجی.

-b size, --buffer=size

جمع‌آوری تعداد size ورودی پیش از نوشتن آن‌ها در خروجی.

--no-timer

غیرفعال کردن نمونه‌برداری مبتنی بر تایمر (SIGPROF) از مقدار اشاره‌گر پشته.

-m, --mmap

ردیابی فراخوانی‌های mmap(2)، mremap(2) و munmap(2) علاوه بر توابع پیش‌فرض.

-?, --help

نمایش راهنما و خروج.

--usage

نمایش پیام کوتاه نحوه استفاده و خروج.

-V, --version

نمایش اطلاعات نسخه و خروج.

گزینه‌های زیر تنها هنگام تولید خروجی گرافیکی اعمال می‌شوند:

-t, --time-based

استفاده از زمان (به‌جای تعداد فراخوانی‌های توابع) به عنوان مقیاس محور X.

-T, --total

رسم نمودار مصرف کل حافظه نیز علاوه بر سایر موارد.

--title=name

استفاده از name به عنوان عنوان نمودار.

-x size, --x-size=size

تنظیم عرض نمودار به میزان size پیکسل.

-y size, --y-size=size

تنظیم ارتفاع نمودار به میزان size پیکسل.

وضعیت خروج (EXIT STATUS)

وضعیت خروج memusage برابر با وضعیت خروج برنامه پروفایل‌شده است.

اشکالات (BUGS)

برای گزارش اشکالات، ببینید: http://www.gnu.org/software/libc/bugs.html

مثال‌ها (EXAMPLES)

در ادامه یک برنامه ساده آمده است که یک بلوک حافظه را در چرخه‌هایی که ابتدا به یک نقطه اوج می‌رسند بازتخصیص می‌دهد و سپس به‌صورت چرخه‌ای با اندازه‌های کوچک‌تر بازتخصیص داده و در نهایت به صفر بازمی‌گرداند. پس از کامپایل برنامه و اجرای دستورات زیر، نمودار مصرف حافظه برنامه را می‌توان در فایل memusage.png مشاهده کرد:

$ memusage --data=memusage.dat ./a.out
...
Memory usage summary: heap total: 45200, heap peak: 6440, stack peak: 224
        total calls  total memory  failed calls
 malloc|         1           400             0
realloc|        40         44800             0  (nomove:40, dec:19, free:0)
 calloc|         0             0             0
   free|         1           440
Histogram for block sizes:
  192-207             1   2% ================
...
 2192-2207            1   2% ================
 2240-2255            2   4% =================================
 2832-2847            2   4% =================================
 3440-3455            2   4% =================================
 4032-4047            2   4% =================================
 4640-4655            2   4% =================================
 5232-5247            2   4% =================================
 5840-5855            2   4% =================================
 6432-6447            1   2% ================
$ memusagestat memusage.dat memusage.png

#include <stdio.h>
#include <stdlib.h>
#define CYCLES 20
int
main(int argc, char *argv[])
{
    int i, j;
    size_t size;
    int *p;
    size = sizeof(*p) * 100;
    printf("malloc: %zu\n", size);
    p = malloc(size);
    for (i = 0; i < CYCLES; i++) {
        if (i < CYCLES / 2)
            j = i;
        else
            j--;
        size = sizeof(*p) * (j * 50 + 110);
        printf("realloc: %zu\n", size);
        p = realloc(p, size);
        size = sizeof(*p) * ((j + 1) * 150 + 110);
        printf("realloc: %zu\n", size);
        p = realloc(p, size);
    }
    free(p);
    exit(EXIT_SUCCESS);
}

همچنین ببینید (SEE ALSO)

memusagestat(1), mtrace(1), ld.so(8)