.\" -*- coding: utf-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH sponge 1 2006-02-19 moreutils moreutils
.SH "نام (NAME)"
sponge \- جذب ورودی استاندارد و نوشتن آن در یک فایل
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBsed '...' file | grep '...' | sponge [-a] file\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
\fBsponge\fR ورودی استاندارد را خوانده و آن را در فایل مشخص‌شده می‌نویسد. برخلاف تغییر مسیر در پوسته (shell redirect)، دستور \fBsponge\fR پیش از نوشتن فایل خروجی، تمام ورودی را جذب (در حافظه ذخیره) می‌کند. این ویژگی امکان ساخت خط‌لوله‌هایی را فراهم می‌کند که از یک فایل می‌خوانند و در همان فایل می‌نویسند.
.PP
اگر فایل خروجی از قبل وجود داشته باشد، \fBsponge\fR مجوزهای دسترسی (permissions) آن را حفظ می‌کند.
.PP
در صورت امکان، \fBsponge\fR با تغییر نام یک فایل موقت به نام فایل مقصد، فایل خروجی را به‌صورت اتمیک (atomic) ایجاد یا به‌روزرسانی می‌کند. (اگر TMPDIR در همان سیستم‌فایل قرار نداشته باشد، انجام این کار ممکن نیست.)
.PP
اگر فایل خروجی یک فایل ویژه (special file) یا پیوند نمادین (symlink) باشد، داده‌ها به‌صورت غیراتمیک در آن نوشته خواهند شد.
.PP
اگر هیچ فایلی مشخص نشود، \fBsponge\fR داده‌ها را به stdout ارسال می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 
\*(T<\fB\-a\fR\*(T>
جایگزین کردن فایل با یک فایل جدید که حاوی محتوای اصلی فایل بوده و ورودی استاندارد به انتهای آن الحاق شده است. در صورت امکان، این عمل به‌صورت اتمیک انجام می‌شود.
.SH "نویسندگان (AUTHORS)"
Colin Watson و Tollef Fog Heen