.\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH REALPATH 1 "16 października 2011" Debian Debian .SH NAZWA realpath \- zwraca absolutną ścieżkę w postaci kanonicznej .SH SKŁADNIA .if !'po4a'hide' .B realpath .if !'po4a'hide' .if !'po4a'hide' .RB [ \-s | \-\-strip ] .if !'po4a'hide' .RB [ \-z | \-\-zero ] \fInazwa_pliku ...\fP .br .if !'po4a'hide' .B realpath .if !'po4a'hide' .BR \-\-h | \-\-help .br .if !'po4a'hide' .B realpath .if !'po4a'hide' .BR \-\-v | \-\-version .SH OPIS \fBrealpath\fP konwertuje każdy podany argument \fInazwa_pliku\fP na pełną ścieżkę do pliku, pozbawioną składników będących dowiązaniami symbolicznymi lub katalogami \fB.\fP albo \fB..\fP. (Więcej informacji można znaleźć w \fBrealpath\fP(3)). .br Każdy komponent ścieżki \fInazwa_pliku\fP musi istnieć. W przeciwnym wypadku \fBrealpath\fP zakończy działanie z niezerowym kodem wyjścia, .br Proszę zauważyć, że tej samej funkcjonalności dostarcza opcja "\-e" polecenia \fBreadlink\fP(1). .PP Jeżeli użyta zostanie opcja \fB\-s\fP, to \fBrealpath\fP usunie z \fInazwy_pliku\fP tylko katalogi \fB.\fP oraz \fB..\fP, bez rozwiązywania dowiązań symbolicznych. Jeżeli podana \fInazwa_pliku\fP jest ścieżką względną (czyli nie zaczyna się od "\fI/\fP"), to przed jej przetworzeniem \fBrealpath \-s\fP wstawi na jej początek nazwę bieżącego katalogu zwróconą przez wywołanie systemowe \fBgetcwd\fP(2). .PP Skonwertowane ścieżki są wypisywane na standardowy wyjściu; każda w osobnej linii. .SH OPCJE .TP 5 .if !'po4a'hide' .BR \-s ", " \-\-strip .\" Usuwa tylko elementy \fB.\fP i \fB..\fP, bez rozwiązywania dowiązań symbolicznych. .TP 5 .if !'po4a'hide' .BR \-z ", " \-\-zero .\" Rozdziela wyjściowe nazwy plików znakiem pustym ("\e0") zamiast znakiem nowej linii, co pozwala na użycie \fBrealpath\fP w połączeniu z opcją "\fI\-0\fP" polecenia \fBxargs\fP(1). .TP 5 .if !'po4a'hide' .BR \-h ", " \-\-help .\" Wyświetla krótką informację o użyciu. .TP 5 .if !'po4a'hide' .BR \-v ", " \-\-version Wyświetla numer wersji polecenia \fBrealpath\fP. .SH PRZYKŁADY .PP W poniższych przykładach przyjęto założenie, że \fI/usr/bin/X11\fP jest dowiązaniem symbolicznym do katalogu \fI/usr/bin\fP. .SS "Przykład 1" Niezależnie od tego, jaki jest bieżący katalog roboczy .br .RS 4 .nf .if !'po4a'hide' .BI "realpath " /../usr/bin/X11/./xterm .fi .RE wyświetla .RS 4 .nf .if !'po4a'hide' .I /usr/bin/xterm .fi .RE ale .RS 4 .nf .if !'po4a'hide' .BI "realpath \-s " /../usr/bin/X11/./xterm .fi .RE wypisuje .RS 4 .nf .if !'po4a'hide' .I /usr/bin/X11/xterm .fi .RE .SS "Przykład 2" Jeżeli \fI/usr/bin/X11\fP (będący dowiązaniem symbolicznym do \fI/usr/bin\fP) jest bieżącym katalogiem roboczym .br .RS 4 .nf .if !'po4a'hide' .BI "realpath " ./xterm .fi .RE oraz .RS 4 .nf .if !'po4a'hide' .BI "realpath \-s " ./xterm .fi .RE będzie .RS 4 .nf .if !'po4a'hide' .I /usr/bin/xterm .ne .RE .SS "Przykład 3" Zakładając że bieżącym katalogiem roboczym jest \fI/home/user\fP (oraz że ten katalog istnieje przed i podczas działania programu relapath), polecenie .br .RS 4 .nf .if !'po4a'hide' .BI "realpath " ../path/to/some/./non-existent/./directory/../or/../file .fi .RE zakończy się następującym błędem: .RS 4 .nf .if !'po4a'hide' .I \&../path/to/some/./non-existent/./directory/../or/../file: No such file or directory .fi .RE ale .RS 4 .nf .if !'po4a'hide' .BI "realpath \-s " ../path/to/some/./non-existent/./directory/../or/../file .fi .RE zwróci .RS 4 .nf .if !'po4a'hide' .I /home/path/to/some/non-existent/file .fi .RE .SH "KOD WYJŚCIA" \fBrealpath\fP zwraca zerowy kod wyjścia, jeżeli \fIwszystkie\fP nazwy ścieżek zostały pomyślnie skonwertowane. .br W razie błędów (np. brakujące lub niedostępne katalogi w ścieżce), \fBrealpath\fP wyświetla komunikat błędu na standardowe wyjście błędów i zwraca niezerowy kod wyjścia. .RE .SH "ZOBACZ TAKŻE" .if !'po4a'hide' .BR basename (1), .if !'po4a'hide' .BR dirname (1), .if !'po4a'hide' .BR readlink (1), .if !'po4a'hide' .BR chase (1), .if !'po4a'hide' .BR realpath (3) .SH BŁĘDY Miejmy nadzieję, że żadnych :) .br Jeżeli jednak znajdziesz jakiś, prosimy zgłosić go w systemie śledzenia błędów Debiana. Opis, jak to zrobić, można znaleźć w pliku \fI/usr/share/doc/debian/bug\-reporting.txt\fP, pochodzącym z pakietu doc\-debian, lub stronie podręcznika \fBreportbug\fP(1). .SH AUTOR Napisany przez Larsa Wirzeniusa jako część pakietu dwww. Obecnie rozwijany i ulepszany przez Roberta Luberdę . .PP realpath jest udostępniany na warunkach Ogólnej licencji publicznej GNU (GNU GPL). Chociaż został napisany dla Debiana, zachęcamy do przenoszenia go do innych systemów.