.nh
.TH "Buf" "1" "2026-07-17" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
buf-breaking \- بررسی تغییرات مخرب (Breaking Changes) در فایل‌های پروتوباف با buf


.SH "خلاصه دستور (SYNOPSIS)"
\fBbuf breaking  --against  [flags]\fP


.SH "توضیحات (DESCRIPTION)"
این دستور اطمینان حاصل می‌کند که مکان ورودی در مقایسه با مکان مبنا هیچ تغییر مخربی (breaking changes) ندارد.

.PP
اولین آرگومان، سورس، ماژول یا ایمیجی است که برای بررسی تغییرات مخرب مشخص می‌شود و باید یکی از قالب‌های [binpb,dir,git,json,mod,protofile,tar,txtpb,yaml,zip] باشد.
در صورت مشخص نشدن هیچ آرگومانی، مقدار پیش‌فرض "." خواهد بود.


.SH "گزینه‌ها (OPTIONS)"
\fB--against\fP=""
	الزامی است، مگر اینکه \fB--against-registry\fP تنظیم شده باشد. سورس، ماژول یا ایمیجی که باید در برابر آن مقایسه انجام شود. باید یکی از قالب‌های [binpb,dir,git,json,mod,protofile,tar,txtpb,yaml,zip] باشد

.PP
\fB--against-config\fP=""
	فایل یا داده‌های buf.yaml که برای پیکربندی سورس، ماژول یا ایمیج مورد مقایسه استفاده می‌شود

.PP
\fB--against-registry\fP[=false]
	اجرای بررسی تغییرات مخرب در برابر آخرین کامیت در شاخه پیش‌فرض رجیستری. تمام ماژول‌های موجود در ورودی باید یک نام پیکربندی‌شده داشته باشند، در غیر این صورت این عملیات ناموفق خواهد بود.
اگر یک ماژول ریموت با نام پیکربندی‌شده یافت نشود، عملیات ناموفق خواهد بود. این گزینه نمی‌تواند همراه با \fB--against\fP تنظیم شود.

.PP
\fB--config\fP=""
	فایل یا داده‌های buf.yaml برای استفاده در پیکربندی

.PP
\fB--disable-symlinks\fP[=false]
	عدم دنبال کردن پیوندهای نمادین (symlinks) هنگام خواندن سورس‌ها یا پیکربندی از سیستم فایل محلی
به‌طور پیش‌فرض، پیوندهای نمادین در این CLI دنبال می‌شوند، اما در Buf Schema Registry هرگز دنبال نخواهند شد

.PP
\fB--error-format\fP="text"
	قالب خطاهای ساخت یا موارد نقض بررسی چاپ‌شده در خروجی استاندارد (stdout). باید یکی از [text,json,msvs,junit,github-actions,gitlab-code-quality] باشد

.PP
\fB--exclude-imports\fP[=false]
	مستثنی کردن موارد import از تشخیص تغییرات مخرب.

.PP
\fB--exclude-path\fP=[]
	مستثنی کردن فایل‌ها یا دایرکتوری‌های خاص، مانند "proto/a/a.proto"، "proto/a"
اگر چندین بار مشخص شود، اجتماع آن‌ها در نظر گرفته می‌شود

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای breaking

.PP
\fB--limit-to-input-files\fP[=false]
	اجرای بررسی تغییرات مخرب فقط در برابر فایل‌های موجود در ورودی
هنگامی که تنظیم شود، ورودی مبنای مقایسه تنها شامل فایل‌های موجود در ورودی خواهد بود
اولویت بالاتری نسبت به \fB--path\fP دارد

.PP
\fB--path\fP=[]
	محدود کردن به فایل‌ها یا دایرکتوری‌های خاص، مانند "proto/a/a.proto"، "proto/a"
اگر چندین بار مشخص شود، اجتماع آن‌ها در نظر گرفته می‌شود


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--debug\fP[=false]
	فعال‌سازی ثبت وقایع خطایابی

.PP
\fB--log-format\fP="color"
	قالب ثبت وقایع [text,color,json]

.PP
\fB--timeout\fP=0s
	مدت زمان تا پایان مهلت زمانی؛ مقدار 0 به معنای نامحدود است


.SH "همچنین ببینید (SEE ALSO)"
\fBbuf(1)\fP


.SH "تاریخچه (HISTORY)"
2026-07-17 تولید خودکار توسط spf13/cobra