کتابخانه‌ی استاندارد · زمان و همروندی

همگام سازی sync

قفل، متغیر شرط، گروه انتظار، قفل خواندن و نوشتن، نشانگر و «یک بار» برای هماهنگ کردن نخ‌ها.

واردسازی همگام سازی

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

وقتی چند نخ یک متغیر را تغییر می‌دهند، باید نوبت را رعایت کنند؛ وگرنه نتیجه به ترتیب تصادفی اجرای نخ‌ها بستگی پیدا می‌کند. بسته‌ی همگام سازی ابزارهای کلاسیک نوبت‌گیری را دارد که روی کتابخانه‌ی نخ سیستم عامل ساخته شده‌اند:

  • قفل: هر نخ پیش از دست زدن به داده قفل را می‌گیرد و پس از آن باز می‌کند. قفل خواندن نوشتن به چند خواننده با هم اجازه‌ی ورود می‌دهد.
  • متغیر شرط: نخ می‌خوابد تا نخ دیگری بگوید چیزی تغییر کرده است.
  • گروه انتظار: پیش از شروع هر کار افزودن، در پایانش اتمام، و انتظار تا شمارش دوباره به صفر برسد.
  • نشانگر (semaphore) تعداد نخ‌هایی را که هم‌زمان درون یک بخش‌اند محدود می‌کند و یک بار آماده‌سازی را فقط یک بار اجرا می‌کند.

خود نخ‌ها از نخ‌ساز و بسته‌ی نخ می‌آیند. برای یک عدد مشترک، اتمی از قفل ارزان‌تر است؛ برای فرستادن مقدار از یک نخ به نخ دیگر، کانال قفل و انتظار را خودش انجام می‌دهد؛ و برای لغو کار، زمینه.

اشتباه‌های رایج:

  • به کار بردن مقداری که هرگز ساخته نشده. هر ابزار این بسته با یک تابع ... جدید ساخته می‌شود؛ همگام سازی.قفل {} خالی هیچ قفلی درونش ندارد و با قفل کردن برنامه را از کار می‌اندازد. متغیرهای سراسری با {} تعریف و در آغاز ریشه ساخته می‌شوند.
  • دو بار قفل کردن. قفل بازگشتی (reentrant) نیست: نخی که قفل کردن را روی قفلی صدا بزند که خودش در دست دارد برای همیشه منتظر می‌ماند. انجام هم هنگام اجرای تابعش قفلی را نگه می‌دارد، پس صدا زدن انجام روی همان یک بار از درون آن تابع هم برنامه را قفل می‌کند.
  • انتظار برای شرط بدون حلقه. انتظار شرط ممکن است پیش از درست شدن شرط برگردد؛ همیشه درون تا وارونه شرط: منتظر بمانید.
  • فراموش کردن نابودسازی. هر ابزار حافظه‌ای از سیستم عامل نگه می‌دارد؛ پس از پیوستن آخرین نخی که از آن استفاده می‌کند، نابودش کنید.

یکپارچه نگه‌داشتن داده با قفل

قفل فقط برای شمارنده نیست. هر چیزی که باید میان چند متغیر درست بماند، مثلاً «جمع پول همه‌ی حساب‌ها همیشه یکی است»، لازم دارد که هر تغییرش وقتی قفل در دست است انجام شود. قفل را در ابتدای تابع بگیرید و باز کردن قفل را در دیرکن بگذارید تا در هر مسیر برگشت، حتی برگشت زودهنگام، آزاد شود.

sync-guide-transfer.salam
واردسازی همگام سازی

ناپایا حساب‌ها := وکتور {} برگردان وکتور<صحیح>
ناپایا قفل حساب := همگام سازی.قفل {}
ناپایا گروه := همگام سازی.گروه انتظار {}

تابع انتقال(مبدا: صحیح، مقصد: صحیح، مبلغ: صحیح): منطقی:
    همگام سازی.قفل کردن(قفل حساب)
    دیرکن همگام سازی.باز کردن قفل(قفل حساب)
    اگر حساب‌ها.بگیر(مبدا) < مبلغ:
        برگشت نادرست
    پایان
    حساب‌ها.بنشان(مبدا، حساب‌ها.بگیر(مبدا) - مبلغ)
    حساب‌ها.بنشان(مقصد، حساب‌ها.بگیر(مقصد) + مبلغ)
    برگشت درست
پایان

تابع کارمند():
    تکرار ۱۰۰۰ در ای:
        انتقال(ای % ۳، (ای + ۱) % ۳، ۷)
    پایان
    همگام سازی.اتمام(گروه)
پایان

تابع ریشه:
    قفل حساب = همگام سازی.قفل جدید()
    گروه = همگام سازی.گروه انتظار جدید()
    حساب‌ها.بیفزا(۵۰۰)
    حساب‌ها.بیفزا(۳۰۰)
    حساب‌ها.بیفزا(۲۰۰)
    همگام سازی.افزودن(گروه، ۴)
    ناپایا کارگرها := وکتور {} برگردان وکتور<صحیح۶۴>
    دیرکن کارگرها.آزادکن()
    تکرار ۴:
        کارگرها.بیفزا(نخ‌ساز(کارمند))
    پایان
    همگام سازی.انتظار(گروه)
    هر ن در کارگرها:
        نخ‌پیوند(ن)
    پایان
    کل := حساب‌ها.بگیر(۰) + حساب‌ها.بگیر(۱) + حساب‌ها.بگیر(۲)
    سرچاپ "پول موجود در بانک:"، کل
    سرچاپ "انتقالی که بیش از موجودی است:"، انتقال(۰، ۱، ۱۰۰۰۰۰)
    حساب‌ها.آزادکن()
    همگام سازی.نابودسازی گروه انتظار(گروه)
    همگام سازی.نابودسازی(قفل حساب)
پایان
خروجیپول موجود در بانک: 1000 انتقالی که بیش از موجودی است: false

چهار نخ ۴۰۰۰ بار پول جابه‌جا می‌کنند و جمع کل هنوز ۱۰۰۰ است. بدون قفل ممکن بود دو نخ هم‌زمان یک موجودی را بخوانند و یکی از تغییرها گم شود.

خواننده‌ی زیاد، نویسنده‌ی کم

وقتی داده خیلی بیشتر خوانده می‌شود تا تغییر کند، مثل تنظیمات یا یک حافظه‌ی نهان، قفل ساده خواننده‌ها را بی‌دلیل منتظر هم نگه می‌دارد. قفل خواندن نوشتن با قفل خواندن هر تعداد خواننده را با هم راه می‌دهد و با قفل نوشتن داده را فقط در اختیار یک نویسنده می‌گذارد.

sync-guide-settings.salam
واردسازی همگام سازی

ناپایا تنظیمات := نگاشت {} برگردان نگاشت<رشته، صحیح>
ناپایا نگهبان := همگام سازی.قفل خواندن نوشتن {}
ناپایا خواندن‌ها := ۰
ناپایا قفل شمارش := همگام سازی.قفل {}

تابع خواننده():
    تکرار ۲۰۰:
        همگام سازی.قفل خواندن(نگهبان)
        سقف := تنظیمات.بگیر("سقف")
        همگام سازی.باز کردن قفل خواندن(نگهبان)
        اگر سقف > ۰:
            همگام سازی.قفل کردن(قفل شمارش)
            خواندن‌ها++
            همگام سازی.باز کردن قفل(قفل شمارش)
        پایان
    پایان
پایان

تابع نویسنده():
    تکرار ۱ تا ۵ در م:
        همگام سازی.قفل نوشتن(نگهبان)
        تنظیمات.درج("سقف"، م * ۱۰)
        همگام سازی.باز کردن قفل نوشتن(نگهبان)
    پایان
پایان

تابع ریشه:
    نگهبان = همگام سازی.قفل خواندن نوشتن جدید()
    قفل شمارش = همگام سازی.قفل جدید()
    تنظیمات.درج("سقف"، ۵)
    الف := نخ‌ساز(خواننده)
    ب := نخ‌ساز(خواننده)
    ن := نخ‌ساز(نویسنده)
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    نخ‌پیوند(ن)
    سرچاپ "تعداد خواندن:"، خواندن‌ها
    سرچاپ "سقف نهایی:"، تنظیمات.بگیر("سقف")
    تنظیمات.آزادکن()
    همگام سازی.نابودسازی(قفل شمارش)
    همگام سازی.نابودسازی قفل خواندن نوشتن(نگهبان)
پایان
خروجیتعداد خواندن: 400 سقف نهایی: 50

خواننده‌ای که فقط قفل خواندن دارد هرگز نباید بنویسد. اگر ممکن است لازم شود داده را تغییر دهد، از اول قفل نوشتن را بگیرد.

محدود کردن تعداد کارهای هم‌زمان

نشانگر تعدادی مجوز نگه می‌دارد. گرفتن یکی برمی‌دارد و اگر چیزی نمانده باشد منتظر می‌ماند، رها کردن آن را پس می‌دهد. با دو مجوز، در هر لحظه حداکثر دو نخ درون بخش محافظت‌شده‌اند؛ دانلودهای موازی یا اتصال‌های پایگاه داده را همین‌طور محدود می‌کنند.

sync-guide-limit.salam
واردسازی همگام سازی

ناپایا جاها := همگام سازی.نشانگر {}
ناپایا قفل := همگام سازی.قفل {}
ناپایا فعال‌ها := ۰
ناپایا بیشینه := ۰
ناپایا تمام‌شده := ۰

تابع دانلود():
    همگام سازی.گرفتن(جاها)
    همگام سازی.قفل کردن(قفل)
    فعال‌ها++
    اگر فعال‌ها > بیشینه:
        بیشینه = فعال‌ها
    پایان
    همگام سازی.باز کردن قفل(قفل)
    همگام سازی.خواب میلی ثانیه(۲۰)
    همگام سازی.قفل کردن(قفل)
    فعال‌ها--
    تمام‌شده++
    همگام سازی.باز کردن قفل(قفل)
    همگام سازی.رها کردن(جاها)
پایان

تابع ریشه:
    جاها = همگام سازی.نشانگر جدید(۲)
    قفل = همگام سازی.قفل جدید()
    ناپایا کارها := وکتور {} برگردان وکتور<صحیح۶۴>
    دیرکن کارها.آزادکن()
    تکرار ۶:
        کارها.بیفزا(نخ‌ساز(دانلود))
    پایان
    هر ن در کارها:
        نخ‌پیوند(ن)
    پایان
    سرچاپ "دانلودهای تمام‌شده:"، تمام‌شده
    سرچاپ "هیچ‌گاه بیش از دو تا با هم:"، بیشینه <= ۲
    همگام سازی.نابودسازی(قفل)
    همگام سازی.نابودسازی نشانگر(جاها)
پایان
خروجیدانلودهای تمام‌شده: 6 هیچ‌گاه بیش از دو تا با هم: true

تلاش برای گرفتن فقط وقتی مجوزی آزاد باشد آن را می‌گیرد و در غیر این صورت بی‌درنگ نادرست برمی‌گرداند؛ برای کاری که باید از آن گذشت، نه این‌که در صف بماند.

آماده‌سازی فقط یک بار

بعضی آماده‌سازی‌ها پرهزینه‌اند و فقط باید اولین باری که لازم شدند انجام شوند، اما ممکن است چند نخ در یک لحظه به آن‌ها نیاز پیدا کنند. انجام تابعش را در نخستین فراخوانی روی یک یک بار اجرا می‌کند؛ بقیه‌ی فراخوانان صبر می‌کنند تا آن اجرا تمام شود و بعد بی‌آن‌که دوباره اجرایش کنند ادامه می‌دهند.

sync-guide-once.salam
واردسازی همگام سازی

ناپایا آماده‌سازی := همگام سازی.یک بار {}
ناپایا جدول := وکتور {} برگردان وکتور<صحیح>
ناپایا ساخت‌ها := ۰

تابع ساختن جدول():
    ساخت‌ها++
    تکرار ۱۰ در ای:
        جدول.بیفزا(ای * ای)
    پایان
پایان

تابع مربع(ع: صحیح): صحیح:
    همگام سازی.انجام(آماده‌سازی، (): ساختن جدول() پایان)
    برگشت جدول.بگیر(ع)
پایان

تابع کارگر():
    _ := مربع(۳)
پایان

تابع ریشه:
    آماده‌سازی = همگام سازی.یک بار جدید()
    الف := نخ‌ساز(کارگر)
    ب := نخ‌ساز(کارگر)
    پ := نخ‌ساز(کارگر)
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    نخ‌پیوند(پ)
    سرچاپ "مربع ۷:"، مربع(۷)
    سرچاپ "جدول"، ساخت‌ها، "بار ساخته شد"
    جدول.آزادکن()
    همگام سازی.نابودسازی یک بار(آماده‌سازی)
پایان
خروجیمربع ۷: 49 جدول 1 بار ساخته شد

صف کار: انتظار برای کار، انتظار برای پایان

متغیر شرط راهی است که نخ تا وقتی کاری نیست بخوابد، به‌جای این‌که در حلقه‌ای بی‌وقفه بررسی کند. کارگرهای زیر تا وقتی صف خالی است روی کار هست منتظر می‌مانند و نخ اصلی پس از هر افزودن اعلام را صدا می‌زند تا یکی از آن‌ها بیدار شود. گروه انتظار کارها را می‌شمارد: پیش از هر افزودن افزودن، پس از پردازش اتمام، و انتظار وقتی برمی‌گردد که همه تمام شده باشند. برای متوقف کردن کارگرها، یک پرچم بگذارید و اعلام سراسری را صدا بزنید که همه را بیدار می‌کند.

sync-guide-queue.salam
واردسازی همگام سازی

ناپایا قفل := همگام سازی.قفل {}
ناپایا کار هست := همگام سازی.متغیر شرط {}
ناپایا کارهای تمام‌شده := همگام سازی.گروه انتظار {}
ناپایا صف := وکتور {} برگردان وکتور<صحیح>
ناپایا برداشته := ۰
ناپایا صف تعطیل := نادرست
ناپایا هزینه‌ی کل := ۰

تابع کارگر():
    همگام سازی.قفل کردن(قفل)
    تا درست:
        تا برداشته == صف.طول() و وارونه صف تعطیل:
            همگام سازی.انتظار شرط(کار هست، قفل)
        پایان
        اگر برداشته == صف.طول(): بشکن پایان
        اندازه := صف.بگیر(برداشته)
        برداشته++
        همگام سازی.باز کردن قفل(قفل)
        هزینه := اندازه * ۲
        همگام سازی.قفل کردن(قفل)
        هزینه‌ی کل += هزینه
        همگام سازی.اتمام(کارهای تمام‌شده)
    پایان
    همگام سازی.باز کردن قفل(قفل)
پایان

تابع ریشه:
    قفل = همگام سازی.قفل جدید()
    کار هست = همگام سازی.متغیر شرط جدید()
    کارهای تمام‌شده = همگام سازی.گروه انتظار جدید()
    کارگرها := [نخ‌ساز(کارگر)، نخ‌ساز(کارگر)، نخ‌ساز(کارگر)]
    تکرار ۱ تا ۱۰ در اندازه:
        همگام سازی.افزودن(کارهای تمام‌شده، ۱)
        همگام سازی.قفل کردن(قفل)
        صف.بیفزا(اندازه)
        همگام سازی.اعلام(کار هست)
        همگام سازی.باز کردن قفل(قفل)
    پایان
    همگام سازی.انتظار(کارهای تمام‌شده)
    سرچاپ "هر ۱۰ کار تمام شد، هزینه‌ی کل"، هزینه‌ی کل
    همگام سازی.قفل کردن(قفل)
    سرچاپ "کسی اعلام نکرد، ۲۰ میلی‌ثانیه صبر شد، بیدار شد:"، همگام سازی.انتظار شرط با مهلت(کار هست، قفل، ۲۰)
    صف تعطیل = درست
    همگام سازی.اعلام سراسری(کار هست)
    همگام سازی.باز کردن قفل(قفل)
    هر ن در کارگرها: نخ‌پیوند(ن) پایان
    سرچاپ "کارگرها ایستادند"
    صف.آزادکن()
    همگام سازی.نابودسازی گروه انتظار(کارهای تمام‌شده)
    همگام سازی.نابودسازی متغیر شرط(کار هست)
    همگام سازی.نابودسازی(قفل)
پایان
خروجیهر ۱۰ کار تمام شد، هزینه‌ی کل 110 کسی اعلام نکرد، ۲۰ میلی‌ثانیه صبر شد، بیدار شد: false کارگرها ایستادند

انتظار شرط هنگام خوابیدن قفل را رها می‌کند و پیش از برگشتن دوباره می‌گیرد؛ برای همین کارگر بلافاصله پس از آن می‌تواند صف را بررسی کند. انتظار شرط با مهلت همین کار را با سقف زمانی انجام می‌دهد: اگر بیدارش کرده باشند درست برمی‌گرداند و اگر زمان تمام شده باشد نادرست. گروه انتظار جای نخ‌پیوند را نمی‌گیرد: به هر نخی که راه انداخته‌اید باز هم باید یک بار بپیوندید.

دام‌ها، و این‌که کدام ابزار

  • وقتی دو قفل لازم است، همه‌ی نخ‌ها باید آن‌ها را به یک ترتیب بگیرند. اگر یک نخ اول الف و بعد ب را بگیرد و نخ دیگر برعکس، ممکن است هر دو بایستند.
  • بخش قفل‌شده را کوتاه نگه دارید. کارهای کند مثل خواندن پرونده یا شبکه را پیش از گرفتن قفل یا پس از آزاد کردنش انجام دهید.
  • هر تابع ... جدید یک نابودسازی ... متناظر دارد. آن را پس از پیوستن آخرین نخی که از آن مقدار استفاده می‌کند صدا بزنید.
وضعیتابزار
چند نخ یک داده را تغییر می‌دهندقفل
داده خیلی بیشتر خوانده می‌شود تا نوشتهقفل خواندن نوشتن
صبر تا N کار تمام شوندگروه انتظار
حداکثر N کار هم‌زماننشانگر
آماده‌سازی‌ای که باید یک بار اجرا شودیک بار
صبر تا شرطی درست شودمتغیر شرط همراه یک قفل
یک عدد مشترکاتمی.صحیح۶۴
رساندن مقدار از یک نخ به نخ دیگرکانال.کانال

گونه‌ها

قفل Mutex

ساختار قفل
قفل؛ در هر لحظه فقط یک نخ آن را در دست دارد.
نامانگلیسیگونهتوضیح
دستگیرهhandleتهی*قفل سیستم‌عامل.
sync-Mutex.salam
واردسازی همگام سازی

ناپایا موجودی := ۰
ناپایا قفل := همگام سازی.قفل {}
ناپایا گروه := همگام سازی.گروه انتظار {}

تابع واریز():
    تکرار ۵۰۰:
        همگام سازی.قفل کردن(قفل)
        موجودی++
        همگام سازی.باز کردن قفل(قفل)
    پایان
    همگام سازی.اتمام(گروه)
پایان

تابع ریشه:
    قفل = همگام سازی.قفل جدید()
    گروه = همگام سازی.گروه انتظار جدید()
    همگام سازی.انتظار(گروه)
    همگام سازی.افزودن(گروه، ۴)
    الف := نخ‌ساز(واریز)
    ب := نخ‌ساز(واریز)
    ج := نخ‌ساز(واریز)
    د := نخ‌ساز(واریز)
    همگام سازی.انتظار(گروه)
    نخ‌پیوند(الف)
    نخ‌پیوند(ب)
    نخ‌پیوند(ج)
    نخ‌پیوند(د)
    سرچاپ "موجودی:"، موجودی
    همگام سازی.نابودسازی گروه انتظار(گروه)
    همگام سازی.نابودسازی(قفل)
پایان
خروجیموجودی: 2000

متغیر شرط CondVar

ساختار متغیر شرط
متغیر شرط: نخ‌ها روی آن می‌خوابند تا نخ دیگری خبرشان کند.
نامانگلیسیگونهتوضیح
دستگیرهhandleتهی*متغیر شرط سیستم‌عامل.
sync-CondVar.salam
واردسازی همگام سازی

ناپایا آماده := نادرست
ناپایا قفل := همگام سازی.قفل {}
ناپایا شرط := همگام سازی.متغیر شرط {}

تابع سازنده():
    همگام سازی.خواب میلی ثانیه(۲۰)
    همگام سازی.قفل کردن(قفل)
    آماده = درست
    همگام سازی.اعلام سراسری(شرط)
    همگام سازی.باز کردن قفل(قفل)
پایان

تابع ریشه:
    قفل = همگام سازی.قفل جدید()
    شرط = همگام سازی.متغیر شرط جدید()
    آغاز := همگام سازی.اکنون میلی ثانیه()
    همگام سازی.قفل کردن(قفل)
    سرچاپ همگام سازی.انتظار شرط با مهلت(شرط، قفل، ۱۰)
    ن := نخ‌ساز(سازنده)
    تا وارونه آماده:
        همگام سازی.انتظار شرط(شرط، قفل)
    پایان
    همگام سازی.باز کردن قفل(قفل)
    نخ‌پیوند(ن)
    سرچاپ آماده، همگام سازی.اکنون میلی ثانیه() - آغاز >= ۲۰
    همگام سازی.اعلام(شرط)
    همگام سازی.نابودسازی متغیر شرط(شرط)
    همگام سازی.نابودسازی(قفل)
پایان
خروجیfalse true true

گروه انتظار WaitGroup

ساختار گروه انتظار
گروه انتظار: شمارنده‌ای از کارهای ناتمام.
نامانگلیسیگونهتوضیح
شمارندهcounterصحیح۶۴*شمار کارهای ناتمام.
قفل درونیmuتهی*قفل درونی.
شرط درونیcvتهی*متغیر شرط درونی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

قفل خواندن نوشتن RWMutex

ساختار قفل خواندن نوشتن
قفل خواندن و نوشتن: چند خواننده با هم، یا یک نویسنده به‌تنهایی.
نامانگلیسیگونهتوضیح
وضعیتstateصحیح۶۴*وضعیت درونی: خواننده‌ها، نویسنده و نویسنده‌های منتظر.
قفل درونیmuتهی*قفل درونی.
شرط درونیcvتهی*متغیر شرط درونی.
sync-RWMutex.salam
واردسازی همگام سازی

تابع ریشه:
    ق := همگام سازی.قفل خواندن نوشتن جدید()
    همگام سازی.قفل خواندن(ق)
    همگام سازی.قفل خواندن(ق)
    سرچاپ "دو خواننده با هم"
    همگام سازی.باز کردن قفل خواندن(ق)
    همگام سازی.باز کردن قفل خواندن(ق)
    همگام سازی.قفل نوشتن(ق)
    سرچاپ "یک نویسنده به‌تنهایی"
    همگام سازی.باز کردن قفل نوشتن(ق)
    همگام سازی.نابودسازی قفل خواندن نوشتن(ق)

    ن := همگام سازی.نشانگر جدید(۲)
    همگام سازی.گرفتن(ن)
    سرچاپ همگام سازی.کوشش برای گرفتن(ن)، همگام سازی.کوشش برای گرفتن(ن)
    همگام سازی.رها کردن(ن)
    سرچاپ همگام سازی.کوشش برای گرفتن(ن)
    همگام سازی.نابودسازی نشانگر(ن)

    ی := همگام سازی.یک بار جدید()
    تکرار ۳:
        همگام سازی.انجام(ی، (): سرچاپ "فقط یک بار" پایان)
    پایان
    همگام سازی.نابودسازی یک بار(ی)
پایان
خروجیدو خواننده با هم یک نویسنده به‌تنهایی true false true فقط یک بار

نشانگر Semaphore

ساختار نشانگر
نشانگر: تعداد محدودی مجوز که نخ‌ها می‌گیرند و پس می‌دهند.
نامانگلیسیگونهتوضیح
مجوزهاpermitsصحیح۶۴*شمار مجوزهای آزاد.
قفل درونیmuتهی*قفل درونی.
شرط درونیcvتهی*متغیر شرط درونی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

یک بار Once

ساختار یک بار
«یک بار»: تابعی را فقط بار اول اجرا می‌کند.
نامانگلیسیگونهتوضیح
انجام شدdoneصحیح۶۴*آیا تابع اجرا شده.
قفل درونیmuتهی*قفل درونی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

تابع‌ها

قفل جدید NewMutex

تابع قفل جدید(): قفل
یک قفل تازه. قفل بازگشتی نیست.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

قفل کردن Lock

تابع قفل کردن(m: قفل): صحیح
قفل را می‌گیرد و اگر نخ دیگری آن را در دست داشته باشد صبر می‌کند. صفر برمی‌گرداند، یا منفی یک اگر سیستم خطا بدهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

باز کردن قفل Unlock

تابع باز کردن قفل(m: قفل): صحیح
قفل را باز می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

نابودسازی Destroy

تابع نابودسازی(m: قفل)
قفل را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

خواب میلی ثانیه SleepMs

تابع خواب میلی ثانیه(ms: صحیح)
نخ فعلی را چند میلی‌ثانیه می‌خواباند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

متغیر شرط جدید NewCondVar

تابع متغیر شرط جدید(): متغیر شرط
متغیر شرط تازه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

انتظار شرط WaitCond

تابع انتظار شرط(cv: متغیر شرط، m: قفل)
قفل را رها می‌کند و می‌خوابد تا خبر برسد؛ پس از بیدار شدن قفل دوباره در دست است. شرط را همیشه در یک حلقه دوباره بررسی کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

انتظار شرط با مهلت WaitCondTimeout

تابع انتظار شرط با مهلت(cv: متغیر شرط، m: قفل، ms: صحیح۶۴): منطقی
مثل انتظار شرط، ولی حداکثر ms میلی‌ثانیه. اگر بیدارش کرده باشند درست و اگر زمان تمام شده باشد نادرست برمی‌گرداند. در هر دو حالت قفل دوباره در دست است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

اکنون میلی ثانیه NowMs

تابع اکنون میلی ثانیه(): صحیح۶۴
زمان ساعت دیواری به میلی‌ثانیه روی لینوکس و مک، و شمارنده‌ی تیک روی ویندوز؛ فقط فاصله‌ی دو خوانش معنا دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

اعلام Signal

تابع اعلام(cv: متغیر شرط)
یکی از نخ‌های منتظر را بیدار می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

اعلام سراسری Broadcast

تابع اعلام سراسری(cv: متغیر شرط)
همه‌ی نخ‌های منتظر را بیدار می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

نابودسازی متغیر شرط DestroyCondVar

تابع نابودسازی متغیر شرط(cv: متغیر شرط)
متغیر شرط را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-CondVar.salam

گروه انتظار جدید NewWaitGroup

تابع گروه انتظار جدید(): گروه انتظار
گروه انتظار تازه با شمار صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

افزودن Add

تابع افزودن(wg: گروه انتظار، delta: صحیح۶۴)
شمارش کارها را delta تغییر می‌دهد؛ آن را پیش از شروع کار صدا بزنید، نه درون آن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

اتمام Done

تابع اتمام(wg: گروه انتظار)
یک کار را تمام‌شده اعلام می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

انتظار Wait

تابع انتظار(wg: گروه انتظار)
صبر می‌کند تا شمارش صفر یا کمتر شود؛ اگر از قبل چنین باشد، بی‌درنگ برمی‌گردد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

نابودسازی گروه انتظار DestroyWaitGroup

تابع نابودسازی گروه انتظار(wg: گروه انتظار)
گروه انتظار را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-Mutex.salam

قفل خواندن نوشتن جدید NewRWMutex

تابع قفل خواندن نوشتن جدید(): قفل خواندن نوشتن
قفل خواندن و نوشتن تازه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

قفل خواندن RLock

تابع قفل خواندن(rw: قفل خواندن نوشتن)
برای خواندن قفل می‌گیرد؛ اگر نویسنده‌ای کار می‌کند یا منتظر است، صبر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

باز کردن قفل خواندن RUnlock

تابع باز کردن قفل خواندن(rw: قفل خواندن نوشتن)
قفل خواندن را باز می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

قفل نوشتن WLock

تابع قفل نوشتن(rw: قفل خواندن نوشتن)
برای نوشتن قفل می‌گیرد و صبر می‌کند تا همه‌ی خواننده‌ها بیرون بروند. نویسنده‌ی منتظر بر خواننده‌های تازه مقدم است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

باز کردن قفل نوشتن WUnlock

تابع باز کردن قفل نوشتن(rw: قفل خواندن نوشتن)
قفل نوشتن را باز می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

نابودسازی قفل خواندن نوشتن DestroyRWMutex

تابع نابودسازی قفل خواندن نوشتن(rw: قفل خواندن نوشتن)
قفل را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

نشانگر جدید NewSemaphore

تابع نشانگر جدید(permits: صحیح۶۴): نشانگر
نشانگری با تعداد مجوز داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

گرفتن Acquire

تابع گرفتن(sem: نشانگر)
یک مجوز می‌گیرد؛ اگر نماند، صبر می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

کوشش برای گرفتن TryAcquire

تابع کوشش برای گرفتن(sem: نشانگر): منطقی
اگر مجوزی آزاد باشد، آن را می‌گیرد و درست برمی‌گرداند؛ صبر نمی‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

رها کردن Release

تابع رها کردن(sem: نشانگر)
یک مجوز پس می‌دهد و یکی از نخ‌های منتظر را بیدار می‌کند. شمار اولیه را بررسی نمی‌کند، پس یک رها کردن اضافه یک مجوز می‌افزاید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

نابودسازی نشانگر DestroySemaphore

تابع نابودسازی نشانگر(sem: نشانگر)
نشانگر را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

یک بار جدید NewOnce

تابع یک بار جدید(): یک بار
«یک بار» تازه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

انجام Do

تابع انجام(o: یک بار، f: تابع())
تابع را فقط اگر بار اول باشد اجرا می‌کند؛ نخ‌های دیگر تا پایانش صبر می‌کنند. هنگام اجرای تابع قفلی را نگه می‌دارد، پس تابع نباید انجام را روی همان یک بار صدا بزند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam

نابودسازی یک بار DestroyOnce

تابع نابودسازی یک بار(o: یک بار)
«یک بار» را آزاد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: sync-RWMutex.salam