.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2000, Andries E. Brouwer <aeb@cwi.nl>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH getpass 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
getpass \- الحصول على كلمة السر
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <unistd.h>\fP
.P
\fB[[deprecated]] char *getpass(const char *\fP\fIprompt\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBgetpass\fP():
.nf
    منذ glibc 2.2.2:
        _XOPEN_SOURCE && ! (_POSIX_C_SOURCE >= 200112L)
            || /* glibc >= 2.19: */ _DEFAULT_SOURCE
            || /* glibc <= 2.19: */ _BSD_SOURCE
    قبل glibc 2.2.2:
        none
.fi
.SH الوصف
هذه الدالة مهملة. لا تستخدمها. انظر الملاحظات. إذا أردت قراءة الإدخال دون
تمكين صدى الطرفية، انظر وصف العلم \fIECHO\fP في \fBtermios\fP(3).
.P
تفتح الدالة \fBgetpass\fP() الملف \fI/dev/tty\fP (الطرفية المسيطرة على العملية)،
وتخرج السلسلة \fIموجه\fP، وتطفئ الصدى، وتقرأ سطرًا واحدًا ("كلمة السر")،
وتستعيد حالة الطرفية وتغلق \fI/dev/tty\fP مرة أخرى.
.SH "قيمة الإرجاع"
ترجع الدالة \fBgetpass\fP() مؤشرًا إلى مخبأ ثابت يحتوي (أول \fBPASS_MAX\fP بايت
من) كلمة السر دون السطر الجديد الزائد، منتهيًا ببايت فارغ
(\[aq]\[rs]0\[aq]). قد يُستبدل هذا المخبأ باستدعاء لاحق. عند الخطأ، تُستعاد
حالة الطرفية، ويُضبط \fIerrno\fP للإشارة إلى الخطأ، ويُعاد NULL.
.SH الأخطاء
.TP 
\fBENXIO\fP
لا تملك العملية طرفية مسيطرة.
.SH الملفات
\fI/dev/tty\fP
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBgetpass\fP()
T}	سلامة الخيوط	MT\-Unsafe term
.TE
.SH المعايير
لا شيء.
.SH التاريخ
الإصدار 7 من AT&T UNIX. موجود في SUSv2، لكنه موسوم بـ LEGACY. أُزيل في
POSIX.1\-2001.
.SH ملاحظات
.\" For libc4 and libc5, the prompt is not written to
.\" .I /dev/tty
.\" but to
.\" .IR stderr .
.\" Moreover, if
.\" .I /dev/tty
.\" cannot be opened, the password is read from
.\" .IR stdin .
.\" The static buffer has length 128 so that only the first 127
.\" bytes of the password are returned.
.\" While reading the password, signal generation
.\" .RB ( SIGINT ,
.\" .BR SIGQUIT ,
.\" .BR SIGSTOP ,
.\" .BR SIGTSTP )
.\" is disabled and the corresponding characters
.\" (usually control-C, control-\[rs], control-Z and control-Y)
.\" are transmitted as part of the password.
.\" Since libc 5.4.19 also line editing is disabled, so that also
.\" backspace and the like will be seen as part of the password.
يجب أن تستخدم بدلاً من ذلك \fBreadpassphrase\fP(3bsd)، المقدم من \fIlibbsd\fP.
.P
في تنفيذ مكتبة GNU C، إذا تعذر فتح \fI/dev/tty\fP، يُكتب الموجه إلى \fIstderr\fP
وتُقرأ كلمة السر من \fIstdin\fP. لا يوجد حد لطول كلمة السر. تحرير السطر غير
معطل.
.P
.\" Libc4 and libc5 have never supported
.\" .B PASS_MAX
.\" or
.\" .BR _SC_PASS_MAX .
وفقًا لـ SUSv2، يجب تعريف قيمة \fBPASS_MAX\fP في \fI<limits.h>\fP في حال
كانت أصغر من 8، ويمكن الحصول عليها في أي حال باستخدام
\fIsysconf(_SC_PASS_MAX)\fP. ومع ذلك، يسحب POSIX.2 الثوابت \fBPASS_MAX\fP و
\fB_SC_PASS_MAX\fP، والدالة \fBgetpass\fP(). تقبل نسخة glibc \fB_SC_PASS_MAX\fP وتعيد
\fBBUFSIZ\fP (مثل 8192).
.SH العلل
يجب على العملية المستدعية تصفير كلمة السر في أقرب وقت ممكن لتجنب ترك كلمة
السر النصية الصريحة مرئية في مساحة عنوان العملية.
.SH "انظر أيضًا"
\fBcrypt\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .