.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "alsatplg" "1" "2018-10-09" "" "راهنمای دستورات عمومی"
.SH "نام (NAME)"
alsatplg \- کامپایلر توپولوژی ALSA
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fIalsatplg\fP <options> [command]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBalsatplg\fP (کامپایلر توپولوژی ALSA) ابزاری برای کامپایل کردن فایل پیکربندی توپولوژی به فایل باینری جهت استفاده در درایورهای هسته است.
.sp
درایورهای صوتی فعلی معمولاً اطلاعات توپولوژی را به‌صورت کد سراسری و ثابت (hard-coded) در سورس‌های درایور قرار می‌دهند: این کار درایور صوتی را به‌شدت به برد توسعه وابسته می‌کند و تغییر درایور برای کار روی دستگاه‌های مختلف را زمان‌بر می‌سازد. همچنین درایور به‌شدت به نسخه فریم‌ور DSP وابسته است، به این معنی که برای همگام نگه داشتن نسخه درایور و فریم‌ور دقت بیشتری لازم است. ویژگی‌های جدید فریم‌ور نیز به معنای به‌روزرسانی درایور خواهد بود.
.sp
پروژه توپولوژی ALSA نیاز به بازنویسی یا پورت کردن درایورهای صوتی برای دستگاه‌های مختلف یا فریم‌ورهای گوناگون را برطرف می‌کند: درایورها فاقد داده‌های توپولوژی ثابت درون کد هستند، به این معنی که یک درایور واحد می‌تواند با به‌روزرسانی داده‌های توپولوژی از طریق سیستم فایل، بر روی دستگاه‌های مختلف استفاده شود. به‌روزرسانی‌های فریم‌ور می‌توانند بدون نیاز به به‌روزرسانی درایورها اعمال شوند. فریم‌ور جدید تنها کافی است شامل یک فایل توپولوژی به‌روزرسانی‌شده باشد که تغییرات را توصیف می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های در دسترس:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-h\fP, \fB\-\-help\fP
نمایش این راهنما
.TP
.B \fB\-V\fP, \fB\-\-version\fP
نمایش نسخه ابزار و نسخه کتابخانه‌های استفاده‌شده
.TP
.B \fB\-c\fP, \fB\-\-compile\fP \fIFILE\fP
فایل پیکربندی مبدأ برای کامپایل
.TP
.B \fB\-d\fP, \fB\-\-decode\fP \fIFILE\fP
فایل باینری توپولوژی مبدأ برای رمزگشایی (decode)
.TP
.B \fB\-n\fP, \fB\-\-normalize\fP \fIFILE\fP
تجزیه و ذخیره فایل پیکربندی در قالب نرمال‌شده (normalized)
.TP
.B \fB\-u\fP, \fB\-\-dump\fP \fIFILE\fP
تجزیه و ذخیره فایل پیکربندی در قالب مشخص‌شده
.TP
.B \fB\-o\fP, \fB\-\-output\fP \fIFILE\fP
فایل خروجی
.TP
.B \fB\-v\fP, \fB\-\-verbose\fP \fILEVEL\fP
تنظیم سطح پرگویی (verbose)
.TP
.B \fB\-s\fP, \fB\-\-sort\fP
مرتب‌سازی شناسه‌های پیکربندی (تنظیم برای نرمال‌سازی)
.TP
.B \fB\-x\fP, \fB\-\-nocheck\fP
ذخیره پیکربندی بدون بررسی صحت (integrity check) اضافی
.TP
.B \fB\-z\fP, \fB\-\-dapm\-nosort\fP
عدم مرتب‌سازی موارد گراف DAPM (مانند نسخه 1.2.1\-)
.UNINDENT
.UNINDENT
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
فایل‌های توپولوژی اصلی برای هر کارت صدای پشتیبانی‌شده در مسیر \fB/usr/share/alsa/topology\fP قرار دارند\&.
.sp
برای نمونه، فایل مورد استفاده اصلی برای کارت \fIbroadwell\fP در مسیر \fB/usr/share/alsa/topology/broadwell/broadwell.conf\fP قرار دارد؛ این فایل سخت‌افزار صوتی را برای درایور توصیف می‌کند.
.sp
برای جزئیات بیشتر در مورد ساختار نحوی فایل‌های UCM، سورس‌کد alsa\-lib را ببینید:
\%<http://\:git\:.alsa-project\:.org/?\:p=alsa-lib\:.git;a=blob;f=src/\:topology/\:parser.c>
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.IP \(bu 2
رابط توپولوژی (Topology Interface): \%<http://\:www\:.alsa-project\:.org/\:alsa-doc/\:alsa-lib/\:group__topology\:.html>
.UNINDENT
.SH "اشکالات (BUGS)"
.sp
مورد شناخته‌شده‌ای وجود ندارد.
.SH "نویسنده (AUTHOR)"
Jaroslav Kysela <perex@perex.cz>
.SH "حق نشر (COPYRIGHT)"
GPLv2+
.\" End of generated man page.