.\" -*- nroff -*-
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH TEMPFILE 1 "27 czerwca 2012" Debian 
.SH NAZWA
tempfile \- w bezpieczny sposób tworzy plik tymczasowy
.SH SKŁADNIA
\fBtempfile\fP [\-d KATALOG] [\-p ŁAŃCUCH] [\-s ŁAŃCUCH] [\-m TRYB] [\-n PLIK]
[\-\-directory=KATALOG] [\-\-prefix=ŁAŃCUCH] [\-\-suffix=ŁAŃCUCH] [\-\-mode=TRYB]
[\-\-name=PLIK] [\-\-help] [\-\-version]
.SH OPIS
.PP
\fBtempfile\fP w bezpieczny sposób tworzy plik tymczasowy. Do wyboru nazwy
korzysta z \fBtempnam\fP(3)  i otwiera plik, używając znaczników O_RDWR |
O_CREAT | O_EXCL. Nazwa pliku jest wypisywana na standardowym
wyjściu. Szczegóły wyboru katalogu można znaleźć w podręczniku
\fBtempnam\fP(3).
.PP
Katalog, w którym zostanie utworzony plik tymczasowy, może zostać wyszukany
w następujący sposób  (ale prosimy przeczytać \fBtempnam\fP(3) po dokładniejszy
opis):
.TP  3
a)
Jeśli istnieje zmienna środowiskowa \fBTMPDIR\fP i zawiera nazwę odpowiedniego
katalogu, to jest używana.
.TP 
b)
W przeciwnym wypadku, jeśli podano argument \fI\-\-directory\fP i jest on
właściwy, to jest używany.
.TP 
c)
W przeciwnym wypadku używane jest \fIP_tmpdir\fP (zdefiniowane w
\fI<stdio.h>\fP), jeśli jest to właściwe.
.TP 
d)
W końcu może zostać użyty katalog zdefiniowany podczas implementacji
(\fI/tmp\fP).
.SH OPCJE
.TP 
\fB\-d, \-\-directory \fP\fIKATALOG\fP
Umieszcza utworzony plik w zadanym KATALOGU.
.TP 
\fB\-m, \-\-mode \fP\fITRYB\fP
Otwiera plik z zadanym TRYBEM, zamiast z domyślnym 0600.
.TP 
\fB\-n, \-\-name \fP\fIPLIK\fP
Używa PLIKU jako nazwy pliku zamiast korzystać z \fBtempnam\fP(3). Jeśli podano
tę opcję, to \-d, \-p i \-s są ignorowane.
.TP 
\fB\-p, \-\-prefix \fP\fIŁAŃCUCH\fP
Do wygenerowania nazwy wykorzystuje do pięciu liter z ŁAŃCUCHA.
.TP 
\fB\-s, \-\-suffix \fP\fIŁAŃCUCH\fP
Tworzy plik z ŁAŃCUCHEM jako przyrostkiem nazwy.
.TP 
\fB\-\-help\fP
Wypisuje na standardowym wyjściu komunikat o sposobie użycia i pomyślnie
kończy pracę.
.TP 
\fB\-\-version\fP
Wypisuje na standardowym wyjściu informację o wersji i pomyślnie kończy
pracę.
.SH "ZWRACANE WARTOŚCI"
Zwrócony kod 0 oznacza, że pomyślnie stworzono plik tymczasowy. Każdy inny
kod wskazuje błąd.
.SH BŁĘDY
Podczas tworzenia plików na partycji NFS nie jest gwarantowane utworzenie
pliku na wyłączność. tempfile nie potrafi utworzyć tymczasowych
katalogów. tempfile nie jest zalecany; zamiast niego należy używać
mktemp(1).
.SH PRZYKŁAD

.RS
.nf
#!/bin/sh
#[...]
t=$(tempfile) || exit
trap "rm \-f \-\- '$t'" EXIT
#[...]
rm \-f \-\- "$t"
trap \- EXIT
exit
.fi
.SH "ZOBACZ TAKŻE"
\fBtempnam\fP(3), \fBmktemp\fP(1)
.SH TŁUMACZENIE
Niniejsze tłumaczenie jest częścią pakietu debianutils.
Strony podręcznika zawarte w pakiecie przetłumaczyli:
Przemek Borys (PTM) <pborys@dione.ids.pl>,
Wojtek Kotwica (PTM) <wkotwica@post.pl>,
Michał Kułach <michal.kulach@gmail.com> oraz
Robert Luberda <robert@debian.org>.
