.\"                                      Hey, EMACS: -*- nroff -*-
.\"
.\" Copyright (c) 1985 Wayne A. Christopher, U. C. Berkeley CAD Group
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH NGSPICE 1 "2014-10-28"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.ds = \-\^\-
.SH "نام (NAME)"
ngspice \- شبیه‌ساز مدار برگرفته از SPICE3f5
.SH "خلاصه دستور (SYNOPSIS)"
\fBngspice\fP [\fIگزینه‌ها\fP] [\fIفایل\fP ...]
.SH "توضیحات (DESCRIPTION)"
این صفحهٔ راهنما تنها یک مرور کلی و مختصر است.
مستندات اصلی ngspice در «راهنمای کاربر ngspice» (ngspice User's Manual) قرار دارد
که به صورت فایل pdf یا html در دسترس است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-n\fP  یا  \fB\*=no\-spiceinit\fP
هنگام راه‌اندازی برای بارگذاری فایل «.spiceinit» تلاش نمی‌کند. در حالت معمول ngspice
ابتدا سعی می‌کند فایل را در دایرکتوری جاری بیابد، و در صورت پیدا نشدن،
به سراغ دایرکتوری خانگی کاربر می‌رود.
.TP
\fB\-t\fP \fIterm\fP  یا  \fB\*=term=\fP\fIterm\fP
برنامه روی ترمینالی با نام \fBmfb\fP مشخص‌شده در \fIterm\fP اجرا می‌شود.
.TP
\fB\-b\fP  یا  \fB\*=batch\fP
اجرا در حالت دسته‌ای (batch).
ngspice ورودی استاندارد یا فایل ورودی مشخص‌شده را خوانده و شبیه‌سازی را انجام می‌دهد.
توجه داشته باشید اگر ورودی استاندارد یک ترمینال نباشد، ngspice به طور پیش‌فرض
در حالت دسته‌ای اجرا خواهد شد، مگر اینکه پرچم \-i مشخص شده باشد.
.TP
\fB\-s\fP  یا  \fB\*=server\fP
اجرا در حالت سرور (server).
این حالت شبیه به حالت دسته‌ای است، با این تفاوت که از یک rawfile موقت استفاده شده و پس از
اتمام شبیه‌سازی، همراه با یک خط حاوی یک کاراکتر «@» پیش از آن، در خروجی استاندارد نوشته می‌شود.
این حالت توسط دیمن ngspice استفاده می‌شود.
.TP
\fB\-i\fP  یا  \fB\*=interactive\fP
اجرا در حالت تعاملی (interactive).
این گزینه زمانی مفید است که ورودی استاندارد یک ترمینال نیست اما حالت تعاملی
مورد نظر است.
با این وجود، تکمیل خودکار دستورها دردسترس نخواهد بود مگر اینکه ورودی استاندارد یک ترمینال باشد.
.TP
\fB\-r\fP \fIrawfile\fP  یا  \fB\*=rawfile=\fP\fIfile\fP
استفاده از \fIrawfile\fP به عنوان فایل پیش‌فرضی که نتایج شبیه‌سازی
در آن ذخیره می‌شوند.
.TP
\fB\-c\fP \fIcircuitfile\fP  یا  \fB\*=circuitfile=\fP\fIcircuitfile\fP
استفاده از \fIcircuitfile\fP به عنوان دسته ورودی (input deck) پیش‌فرض.
.TP
\fB\-h\fP  یا  \fB\*=help\fP
نمایش راهنمای کامل درباره آرگومان‌های دردسترس برنامه.
.TP
\fB\-v\fP  یا  \fB\*=version\fP
نمایش شماره نسخه و اطلاعات کپی‌رایت برنامه.
.TP
\fB\-a\fP  یا  \fB\*=autorun\fP
FIXME
.TP
\fB\-o\fP \fIoutfile\fP  یا  \fB\*=output=\fP\fIoutfile\fP
تمام گزارش‌های تولیدشده در حین یک اجرای دسته‌ای (\fB\-b\fP) در \fIoutfile\fP ذخیره خواهند شد.
.TP
\fB\-p\fP  یا  \fB\*=pipe\fP
به یک برنامه (مانند xcircuit) اجازه می‌دهد تا از طریق یک لوله (pipe) به عنوان رابط گرافیکی (GUI frontend) برای
ngspice عمل کند.
بدین ترتیب ngspice فرض می‌کند که لوله یک tty است و امکان اجرا در حالت تعاملی را فراهم می‌سازد.
.PP
آرگومان‌های بعدی به عنوان بسته‌های ورودی SPICE در نظر گرفته می‌شوند که خوانده
و ذخیره می‌گردند.
(اگر حالت دسته‌ای درخواست شده باشد، آن‌ها بلافاصله اجرا می‌شوند.)
.SH "محیط (ENVIRONMENT)"
.TP
\fBSPICE_LIB_DIR\fP
.TP
\fBSPICE_EXEC_DIR\fP
.TP
\fBSPICE_HOST\fP
.TP
\fBSPICE_BUGADDR\fP
.TP
\fBSPICE_EDITOR\fP
.TP
\fBSPICE_ASCIIRAWFILE\fP  پیش‌فرض  \fI0\fP
قالب rawfile.
\fI0\fP برای باینری، و \fI1\fP برای ascii.
.TP
\fBSPICE_NEWS\fP  پیش‌فرض  \fI$SPICE_LIB_DIR/news\fP
فایلی که هنگام شروع ngspice در حالت تعاملی، عیناً در stdout کپی می‌شود.
.TP
\fBSPICE_MFBCAP\fP  پیش‌فرض  \fI$SPICE_LIB_DIR/mfbcap\fP
.TP
\fBSPICE_HELP_DIR\fP  پیش‌فرض  \fI$SPICE_LIB_DIR/helpdir\fP
.TP
\fBSPICE_SCRIPTS\fP  پیش‌فرض  \fI$SPICE_LIB_DIR/scripts\fP
فایل \fIspinit\fP در این دایرکتوری جستجو خواهد شد.
.TP
\fBSPICE_PATH\fP  پیش‌فرض  \fI$SPICE_EXEC_DIR/ngspice\fP
.PP
متغیرهای محیطی گوناگون و ثبت‌نشدهٔ مختص ngspice:
.TP
\fBNGSPICE_MEAS_PRECISION\fP
.TP
\fBSPICE_NO_DATASEG_CHECK\fP
.PP
متغیرهای محیطی متداول:
.TP
\fBTERM\fP \fBLINES\fP \fBCOLS\fP \fBDISPLAY\fP \fBHOME\fP \fBPATH\fP \fBEDITOR\fP \fBSHELL\fP
.TP
\fBPOSIXLY_CORRECT\fP
.SH "فایل‌ها (FILES)"
.TP
\fI$SPICE_LIB_DIR/scripts/spinit\fP
فایل مقداردهی اولیه سیستم.
.TP
\fI\&.spiceinit\fP  یا  \fI$HOME/.spiceinit\fP
فایل مقداردهی اولیه کاربر.
.SH "همچنین ببینید (SEE ALSO)"
sconvert(1)، ngnutmeg(1)، mfb(3)، writedata(3) و
.br
راهنمای کاربر ngspice در \fBhttp://ngspice.sourceforge.net/docs.html\fP
.SH "گزارش باگ‌ها (BUGS)"
لطفاً باگ‌ها را از طریق پیوند زیر به پروژه ngspice گزارش دهید:
.br
\fBhttp://ngspice.sourceforge.net/bugrep.html\fP
.SH "نویسندگان (AUTHORS)"
\fBspice3\fP:  Tom Quarles (quarles@cad.berkeley.edu)
.br
\fBnutmeg\fP: رابط کاربری: Wayne Christopher (faustus@cad.berkeley.edu)
.br
\fBngspice\fP: نویسندگان مختلف (نگاه کنید به \fBhttps://sourceforge.net/projects/ngspice\fP)