'\" t
.\"     Title: uuidgen
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: دستورات کاربر
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "UUIDGEN" "1" "2026-09-02" "util\-linux 2.42.3" "دستورات کاربر"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
uuidgen \- ایجاد شناسه‌های منحصربه‌فرد جهانی (UUID)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBuuidgen\fP [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBuuidgen\fP با استفاده از کتابخانه \fBlibuuid\fP(3) یک شناسه منحصربه‌فرد جهانی (UUID) جدید ایجاد (و چاپ) می‌کند. این UUID جدید را می‌توان به‌طور منطقی در میان تمام UUIDهای ایجادشده در سیستم محلی، و در میان UUIDهای ایجادشده در سیستم‌های دیگر در گذشته و آینده، یکتا در نظر گرفت.
.sp
سه نوع UUID وجود دارد که \fBuuidgen\fP می‌تواند تولید کند: UUIDهای مبتنی بر زمان (time\-based)، UUIDهای مبتنی بر تصادف (random\-based)، و UUIDهای مبتنی بر هش (hash\-based). به‌طور پیش‌فرض، اگر یک تولیدکننده اعداد تصادفی با کیفیت بالا موجود باشد، \fBuuidgen\fP یک UUID مبتنی بر تصادف تولید می‌کند. در غیر این صورت، یک UUID مبتنی بر زمان انتخاب می‌کند. می‌توان با استفاده از گزینه‌های \fB\-\-random\fP یا \fB\-\-time\fP، تولید یکی از این دو نوع نخست UUID را اجبار کرد.
.sp
نوع سوم UUID با گزینه‌های \fB\-\-md5\fP یا \fB\-\-sha1\fP، و به دنبال آن \fB\-\-namespace\fP \fInamespace\fP و \fB\-\-name\fP \fIname\fP تولید می‌شود. مقدار \fInamespace\fP ممکن است یک UUID شناخته‌شده باشد، یا یک نام مستعار برای یکی از UUIDهای شناخته‌شده تعریف‌شده در RFC 4122، یعنی \fB@dns\fP، \fB@url\fP، \fB@oid\fP یا \fB@x500\fP باشد. مقدار \fIname\fP یک رشته دلخواه است. UUID تولیدشده، چکیده (digest) حاصل از الحاق فضای نام UUID و مقدار نام است که با الگوریتم‌های MD5 یا SHA1 هش شده است. بنابراین این یک مقدار قابل پیش‌بینی است که ممکن است زمانی مفید باشد که UUIDها به عنوان دستگیره‌ها (handles) یا نانس‌ها (nonces) برای مقادیر پیچیده‌تر یا مقادیری که نباید مستقیماً افشا شوند استفاده می‌شوند. برای اطلاعات بیشتر RFC را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-r\fP، \fB\-\-random\fP
.RS 4
تولید یک UUID مبتنی بر تصادف. این روش یک UUID متشکل از بیت‌های عمدتاً تصادفی ایجاد می‌کند. این روش نیازمند آن است که سیستم‌عامل دارای یک تولیدکننده اعداد تصادفی با کیفیت بالا باشد، مانند \fI/dev/random\fP.
.RE
.sp
\fB\-t\fP، \fB\-\-time\fP
.RS 4
تولید یک UUID مبتنی بر زمان. این روش یک UUID بر اساس ساعت سیستم به‌علاوه آدرس سخت‌افزاری اترنت سیستم (در صورت وجود) ایجاد می‌کند.
.RE
.sp
\fB\-m\fP، \fB\-\-md5\fP
.RS 4
استفاده از MD5 به عنوان الگوریتم هش.
.RE
.sp
\fB\-s\fP، \fB\-\-sha1\fP
.RS 4
استفاده از SHA1 به عنوان الگوریتم هش.
.RE
.sp
\fB\-6\fP، \fB\-\-time\-v6\fP
.RS 4
تولید یک UUID مبتنی بر زمان. این روش یک UUID بر اساس ساعت سیستم ایجاد می‌کند و بر اساس برچسب زمانی درون آن، از نظر لغت‌نگاری (lexicographically) قابل مرتب‌سازی است.
.RE
.sp
\fB\-7\fP، \fB\-\-time\-v7\fP
.RS 4
تولید یک UUID مبتنی بر زمان. این روش یک UUID بر اساس ساعت سیستم ایجاد می‌کند و بر اساس برچسب زمانی درون آن، از نظر لغت‌نگاری قابل مرتب‌سازی است.
.RE
.sp
\fB\-n\fP، \fB\-\-namespace\fP \fInamespace\fP
.RS 4
تولید هش با پیشوند \fInamespace\fP. مقدار \fInamespace\fP یک UUID است، یا \*(Aq@ns\*(Aq که در آن "ns" یک UUID از پیش تعریف‌شده و شناخته‌شده است که با نام فضای نام به آن اشاره می‌شود (به بالا مراجعه کنید).
.RE
.sp
\fB\-N\fP، \fB\-\-name\fP \fIname\fP
.RS 4
تولید هش از \fIname\fP.
.RE
.sp
\fB\-C\fP، \fB\-\-count\fP \fInum\fP
.RS 4
تولید چندین UUID با استفاده از قابلیت ارتقایافته libuuid برای کش کردن UUIDهای مبتنی بر زمان، که در نتیجه باعث بهبود کارایی می‌شود. با این حال، این موضوع برای انواع دیگر UUID اهمیتی ندارد.
.RE
.sp
\fB\-x\fP، \fB\-\-hex\fP
.RS 4
تفسیر \fIname\fP به عنوان یک رشته هگزادسیمال.
.RE
.sp
\fB\-h\fP، \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP، \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "مطابق با (CONFORMING TO)"
.sp
OSF DCE 1.1
.SH "مثال‌ها (EXAMPLES)"
.sp
uuidgen \-\-sha1 \-\-namespace @dns \-\-name "www.example.com"
.SH "نویسندگان (AUTHORS)"
.sp
دستور \fBuuidgen\fP توسط Andreas Dilger برای \fBlibuuid\fP(3) نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBuuidparse\fP(1)،
\fBlibuuid\fP(3)،
\c
.URL "https://tools.ietf.org/html/rfc4122" "RFC 4122"
.URL "https://tools.ietf.org/html/rfcXXXX" "RFC XXXX" ""
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBuuidgen\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.