.\"**************************************************************************
.\"*                                                                        *
.\"*                                 OCaml                                  *
.\"*                                                                        *
.\"*             Xavier Leroy, projet Cristal, INRIA Rocquencourt           *
.\"*                                                                        *
.\"*   Copyright 1996 Institut National de Recherche en Informatique et     *
.\"*     en Automatique.                                                    *
.\"*                                                                        *
.\"*   All rights reserved.  This file is distributed under the terms of    *
.\"*   the GNU Lesser General Public License version 2.1, with the          *
.\"*   special exception on linking described in the file LICENSE.          *
.\"*                                                                        *
.\"**************************************************************************
.\"
.TH OCAMLPROF 1

.SH "نام (NAME)"
ocamlprof \- پروفایلر OCaml

.SH "خلاصه دستور (SYNOPSIS)"
.B ocamlprof
[
.I گزینه‌ها
]
.I نام‌فایل ...

.SH "توضیحات (DESCRIPTION)"
دستور
.B ocamlprof
تعداد دفعات اجرای گردآوری‌شده در حین اجرای یک برنامه OCaml را که با
.BR ocamlcp (1)
ابزارگذاری شده است، چاپ می‌کند.
.PP
این دستور فهرستی از کد منبع ماژول‌های برنامه را که به‌عنوان آرگومان مشخص شده‌اند، همراه با تعداد دفعات اجرا که به‌صورت یادداشت (کامنت) درج شده‌اند، تولید می‌کند. برای نمونه،
.PP
.B ocamlprof foo.ml
.PP
کد منبع ماژول foo را همراه با یادداشت‌هایی که نشان می‌دهند توابع این ماژول چند بار فراخوانی شده‌اند چاپ می‌کند. طبیعتاً این اطلاعات تنها در صورتی دقیق است که فایل منبع پس از اجرای پروفایل‌سازی دستخوش تغییر نشده باشد.

.SH "گزینه‌ها (OPTIONS)"

.TP
.BI \-f " dumpfile"
یک فایل رونوشت (dump) جایگزین برای اطلاعات پروفایل‌سازی مشخص می‌کند.
.TP
.BI \-F " string"
یک رشته اضافی را برای خروجی همراه با اطلاعات پروفایل‌سازی مشخص می‌کند.
به‌طور پیش‌فرض،
.BR ocamlprof (1)
برنامه‌ها را با یادداشت‌هایی به فرم
.BI (* " n " *)
حاشیه‌نویسی می‌کند که در آن
.I n
مقدار شمارنده برای یک نقطه پروفایل‌سازی است. با گزینه
.BI \-F " s"
این حاشیه‌نویسی به‌صورت
.BI (* " sn " *)
خواهد بود.
.TP
.BI \-impl " filename"
فایل
.I filename
را به‌صورت یک فایل پیاده‌سازی کامپایل می‌کند، حتی اگر پسوند آن .ml نباشد.
.TP
.BI \-intf " filename"
فایل
.I filename
را به‌صورت یک فایل رابط (interface) کامپایل می‌کند، حتی اگر پسوند آن .mli نباشد.
.TP
.BI \-keywords " version+list"
کلیدواژه‌ها را بر اساس مشخصات
.IR version+list
تنظیم می‌کند.
.TP
.B \-version
چاپ رشته نسخه و خروج.
.TP
.B \-vnum
چاپ شماره نسخه کوتاه و خروج.
.TP
.BR \-help " یا " \-\-help
نمایش خلاصه‌ای کوتاه از نحوه استفاده و خروج.

.SH "همچنین ببینید (SEE ALSO)"
.BR ocamlcp (1).
.br
.IR The\ OCaml\ user's\ manual ,
فصل "Profiling".