.\" -*- coding: UTF-8 -*-
.\" $File: file.man,v 1.140 2020/06/07 17:41:07 christos Exp $
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.Dd June 7, 2020
.Dt FILE 1
.Os
.Sh NAZWA
.Nm file
.Nd określa typ pliku
.Sh SKŁADNIA
.Nm
.Bk -words
.Op Fl bcdEhiklLNnprsSvzZ0
.Op Fl Fl apple
.Op Fl Fl exclude-quiet
.Op Fl Fl extension
.Op Fl Fl mime-encoding
.Op Fl Fl mime-type
.Op Fl e Ar nazwa-testu
.Op Fl F Ar separator
.Op Fl f Ar nazwa-pliku
.Op Fl m Ar pliki-magiczne
.Op Fl P Ar nazwa=wartość
.Ar
.Ek
.Nm
.Fl C
.Op Fl m Ar pliki-magiczne
.Nm
.Op Fl Fl help
.Sh OPIS
Niniejsza strona podręcznika dokumentuje wersję 5.39 polecenia
.Nm .
.Pp
.Nm
sprawdza każdy ze swoich argumentów, próbując go
sklasyfikować. Istnieją trzy zestawy testów, które są wykonywane w
następującej kolejności: testy systemu plików, testy liczb magicznych i
testy języka.  Pierwszy test zakończony powodzeniem powoduje wypisanie typu
pliku.
.Pp
Wypisany typ będzie zwykle zawierał jedno ze słów
.Em text
(plik zawiera
tylko znaki drukowalne i kilka spośród znaków sterujących oraz
prawdopodobnie można go bezpiecznie czytać na terminalu
.Dv ASCII ) ,
.Em executable
(wykonywalny -- plik zawiera wyniki kompilacji w formacie
zrozumiałym dla jądra pewnego
.Tn Uniksa
lub innego systemu) lub
.Em data
(dane) oznaczające cokolwiek innego (zwykle jest to binarny,
niedrukowalny plik). Wyjątkami są ogólnie znane formaty plików (pliki core,
archiwa tar), o których wiadomo, że zawierają dane binarne. Podczas
dodawania lokalnych modyfikacji do pliku /etc/magic, proszę
.Em "zachować te słowa kluczowe" .
Wielu polega na tym, że dla wszystkich czytelnych
plików wypisywane jest słowo "text". Nie należy więc robić tego, co zrobiono
w Berkeley - zmieniono tam "shell commands text" na "shell script".
.Pp
Testy systemu plików są oparte o sprawdzanie wartości zwracanej przez
funkcję systemową
.Xr stat 2 .
Program sprawdza, czy plik jest pusty oraz
czy jest jakiegoś rodzaju plikiem specjalnym. Powinno się dać rozpoznać
wszystkie rodzaje plików występujące w danym systemie (gniazda, dowiązania
symboliczne lub nazwane potoki (FIFO), w systemach które je
zaimplementowały), o ile te rodzaje plików będą zdefiniowane w systemowym
pliku nagłówkowym
.In sys/stat.h.
.Pp
Testy  liczb  magicznych  służą  do  sprawdzania  plików, które zawierają
dane w określonym formacie. Dobrym tego przykładem jest wykonywalny plik
binarny (skompilowany program) a.out, którego format jest zdefiniowany w
.In elf.h,
.In a.out.h
i prawdopodobnie
.In exec.h
w standardowym katalogu plików nagłówkowych.  Pliki te zawierają "liczby
magiczne" w określonym miejscu, w pobliżu początku pliku. Liczby te
informują
.Tn uniksowy
system operacyjny o tym, że plik jest wykonywalnym
plikiem binarnym oraz który z możliwych typów reprezentuje. Koncepcja "liczb
magicznych" została jako rozszerzenie zastosowana również do plików z
danymi. Można tak opisać każdy plik posiadający niezmienny identyfikator
przy małym i określonym przesunięciu względem początku pliku. Informacje
identyfikujące te pliki są odczytywane ze skompilowanego pliku liczb
magicznych
.Pa /usr/share/misc/magic.mgc
lub z katalogu
.Pa /usr/share/misc/magic ,
gdy skompilowany plik nie istnieje. Dodatkowo, pliki
.Pa $HOME/.magic.mgc
lub
.Pa $HOME/.magic ,
jeśli będą istniały,
zostaną użyte z pierwszeństwem w stosunku do systemowych plików magicznych.
.Pp
Jeśli plik nie pasuje do żadnego z wpisów w pliku liczb magicznych,
dokonywane jest sprawdzenie czy jest to plik tekstowy. Rozpoznawane są
zestawy znaków: ASCII, ISO-8859-x, 8-bitowe rozszerzenia ASCII niezgodne z
ISO (używane w systemach Macintosh i IBM PC), Unicode w kodowaniu UTF-8,
Unicode w kodowaniu UTF-16 oraz EBCDIC. Sprawdzane są zakresy i ciągi
bajtów, które stanowią drukowalny tekst w każdym z tych zestawów znaków.
Jeśli plik przejdzie któryś z tych testów, zgłaszany jest odpowiadający mu
zestaw znaków. Pliki w ASCII, ISO-8859-x, UTF-8 oraz w rozszerzeniach ASCII
są identyfikowane jako
.Dq text ,
gdyż mogą  być one na ogół czytane na
dowolnym terminalu; pliki w UTF-16 i EBCDIC stanowią jedynie "character
data" (dane znakowe), gdyż jeśli zawierają one tekst, tekst ten wymaga przed
przeczytaniem konwersji. Dodatkowo,
.Nm
będzie próbował określić inne
charakterystyki plików tekstowych. Jeśli wiersze są zakończone znakami CR,
CRLF lub NEL, zamiast standardowego uniksowego LF, zostanie to
zgłoszone. Zostaną również zidentyfikowane pliki zawierające wbudowane
sekwencje unikowe lub wielokrotnego drukowania.
.Pp
Po określeniu przez
.Nm
zestawu znaków używanego w pliku tekstowym,
spróbuje on odgadnąć w jakim języku plik został napisany. Testy językowe
składają się z poszukiwań określonych łańcuchów  znakowych (por.
.In names.h)
, które mogą pojawić się gdziekolwiek w kilku pierwszych blokach pliku. Na
przykład słowo kluczowe
.Em .br
wskazuje, że plik jest najprawdopodobniej
plikiem wejściowym dla programu
.Xr troff 1
podobnie, jak
.Em struct
wskazuje na program w C. Testy te są mniej godne zaufania niż poprzednie
dwie grupy, więc są wykonywane na końcu. Testy językowe testują również
niektóre pliki zbiorcze (jak archiwa
.Xr tar 1 ,
pliki JSON).
.Pp
Plik, który nie może zostać określony jako jako zapisany w jednym z
powyższych zestawów znaków, jest po prostu określany jako "data" (dane).
.Sh OPCJE
.Bl -tag -width indent
.It Fl Fl apple
Powoduje, że polecenie file wypisuje typ pliku i kod twórcy zgodnie z
zapisem używanym w starszych wersjach MacOS. Kod składa się z ośmiu liter,
pierwsza opisuje typ pliku, ostatnia twórcę. Opcja ta działa poprawnie
jedynie dla formatów plików ze wyjściem zdefiniowanym w niniejszym zapisie.
.It Fl b , Fl Fl brief
Nie podaje nazw plików na początku wierszy wynikowych (tryb skrócony).
.It Fl C , Fl Fl compile
Zapisuje plik wynikowy
.Pa magic.mgc ,
który zawiera wstępnie przetworzoną
wersję pliku lub katalogu.
.It Fl c , Fl Fl checking-printout
Powoduje sprawdzenie wydruku przetworzonej postaci pliku magicznego. Jest to
zwykle używane w połączeniu z
.Fl m ,
aby odpluskwić nowy plik liczb
magicznych przed jego zainstalowaniem.
.It Fl d
Wypisuje wewnętrzne informacje debugowania na standardowe wyjście błędów.
.It Fl E
W przypadku błędów systemu plików (np. nie znaleziono pliku) nie obsługuje
błędu jako normalnego wyniku i nie kontynuuje działania, jak wymaga norma
POSIX, lecz wyświetla błąd i wychodzi.
.It Fl e , Fl Fl exclude Ar nazwa-testu
Wyłącza test o nazwie
.Ar nazwa-testu
z listy testów, przeprowadzanych w
celu określenia typu pliku. Poprawne nazwy testów to:
.Bl -tag -width compress
.It apptype
Typ aplikacji
.Dv EMX
(tylko na EMX).
.It ascii
Różne typy plików tekstowych (ten test stara się odgadnąć kodowanie tekstu,
niezależnie od opcji "encoding").
.It encoding
Różne kodowania tekstowe do testów magicznych soft.
.It tokens
Ignorowane w celu zachowania kompatybilności wstecznej.
.It cdf
Wypisuje szczegóły plików Compound Document File.
.It compress
Wyszukuje i zagłębia się w pliki skompresowane.
.It csv
Wyszukuje plików z wartościami rozdzielonymi przecinkiem (ang. Comma
Separated Value - CSV)
.It elf
Wypisuje szczegóły pliku ELF, zakładając że włączone są testy magiczne soft
i odszukano magiczne elf.
.It json
Sprawdza pliki JSON (RFC-7159) pod kątem poprawności.
.It soft
Sprawdza z plikami magicznymi.
.It tar
Sprawdza pliki tar weryfikując sumę kontrolną 512-bajtowego nagłówka
archiwum. Wyłączenie tego testu może dać bardziej szczegółowy opis
zawartości, przy użyciu metody soft.
.It text
Synonim
.Sq ascii .
.El
.It Fl Fl exclude-quiet
Podobnie jak
.Fl Fl exclude
lecz ignoruje testy, których nie zna
.Nm .
Zapewnia to kompatybilność ze starszymi wersjami programu
.Nm .
.It Fl Fl extension
Wyświetla listę prawidłowych rozszerzeń dla znalezionego typu pliku,
rozdzielonych ukośnikiem.
.It Fl F , Fl Fl separator Ar separator
Używa podanego łańcucha jako separatora między nazwą pliku a zwróconym
wynikiem pliku. Domyślnie jest to "\&:".
.It Fl f , Fl Fl pliki-od Ar nazwa-pliku
Odczytuje nazwy testowanych plików z
.Ar nazwa-pliku
(po jednym w
wierszu) przed listą argumentów. Obecna musi być albo
.Ar nazwa-pliku
albo przynajmniej jeden argument będący nazwą pliku; aby testować
standardowe wejście, należy użyć argumentu "-" jako nazwy pliku. Proszę
zauważyć, że
.Ar nazwa-pliku
nie jest rozwijana, a nazwy plików są
przetwarzane przy wystąpieniu tej opcji przed wszystkimi innymi
opcjami. Pozwala to na przetworzenie wielu list plików z różnymi argumentami
wiersza polecenia, w tym samym wywołaniu
.Nm .
Z tego powodu, jeśli chce
się ustawić ogranicznik, konieczne jest zrobienie tego przed podaniem listy
plików, np. "
.Fl F Ar @ Fl f Ar nazwa-pliku
", zamiast: "
.Fl f Ar nazwa-pliku Fl F Ar @
".
.It Fl h , Fl Fl no-dereference
opcja powoduje, że nie zachodzi podążanie za dowiązaniami symbolicznymi (w
systemach, które obsługują dowiązania symboliczne). Jest to domyślne
zachowanie, jeśli nie zdefiniowano zmiennej środowiskowej
.Dv POSIXLY_CORRECT .
.It Fl i , Fl Fl mime
Powoduje, że polecenie file wypisuje łańcuchy typów mime, zamiast
tradycyjnych nazw czytelnych dla użytkownika. Stąd, pojawić się może
"text/plain; charset=us-ascii", zamiast "ASCII text".
.It Fl Fl mime-type , Fl Fl mime-encoding
Jak
.Fl i ,
lecz wypisuje jedynie określone element(y).
.It Fl k , Fl Fl keep-going
Nie zatrzymuje się po pierwszym dopasowaniu. Kolejne dopasowania będą
poprzedzone łańcuchem "\[rs]012\- " (aby osiągnąć znak nowego wiersza,
proszę skorzystać z opcji
.Fl r ) .
Wygrywa najsilniejszy wzór magiczny
(patrz opcja
.Fl l ) .
.It Fl l , Fl Fl list
Pokazuje listę wzorców i ich siłę posortowanych malejącą według siły
.Xr magic 5 ,
która jest używana do dopasowania (zobacz też opcję
.Fl k ) .
.It Fl L , Fl Fl dereference
Powoduje, że program podąża za dowiązaniami symbolicznymi, tak jak w
przypadku opcji
.Xr ls 1
(w systemach obsługujących dowiązania
symboliczne) o identycznej nazwie. Jest to domyślne zachowanie, jeśli
zdefiniowano zmienną środowiskową
.Ev POSIXLY_CORRECT .
.It Fl m , Fl Fl plik-magiczny Ar pliki-magiczne
Podaje alternatywną listę plików i katalogów zawierających magię. Może być
to pojedynczy plik lub rozdzielona dwukropkami lista plików. Jeśli razem z
plikiem lub katalogiem zostanie znaleziony skompilowany plik magiczny,
zostanie użyty zamiast pliku lub katalogu.
.It Fl N , Fl Fl no-pad
Nie wyrównuje nazw plików tak, aby wynik wyglądał lepiej.
.It Fl n , Fl Fl no-buffer
Wymusza opróżnienie standardowego wyjścia po sprawdzeniu każdego pliku. Jest
to przydatne wyłącznie przy sprawdzaniu listy plików. Opcja jest
przeznaczona do programów oczekujących wyniku z typem plików, pozyskanego z
potoku.
.It Fl p , Fl Fl preserve-date
W systemach obsługujących
.Xr utime 3
lub
.Xr utimes 2 ,
stara się
zachować czas dostępu analizowanych plików, aby udać, że
.Nm
nigdy ich
nie odczytało.
.It Fl P , Fl Fl parameter Ar nazwa=wartość
Ustawia różne limity parametrów.
.Bl -column elf_phnum Default XXXXXXXXXXXXXXXXXXXXXXXXXXX -offset indent
.It Sy Nazwa Ta Sy Domyślnie Ta Sy Opis
.It Li bytes Ta 1048576 Ta maks. liczba bajtów do odczytu z pliku
.It Li elf_notes Ta 256 Ta maks. liczba przetw. węzłów ELF
.It Li elf_phnum Ta 2048 Ta maks. liczba przetw. sekcji programu ELF
.It Li elf_shnum Ta 32768 Ta maks. liczba przetw. sekcji ELF
.It Li indir Ta 50 Ta limit rekurencji dla magii niebezpośr.
.It Li name Ta 50 Ta use count limit for name/use magic
.It Li regex Ta 8192 Ta limit długości dla przeszukiwań wyr. reg.
.El
.It Fl r , Fl Fl raw
Nie tłumaczy niedrukowalnych znaków na \eooo. Zwykle
.Nm
tłumaczy znaki
niedrukowalne na ich postać ósemkową.
.It Fl s , Fl Fl pliki-specjalne
Normalnie,
.Nm
próbuje czytać i określać rodzaj pliku jedynie dla tych
argumentów, które są plikami zgłoszonymi przez
.Xr stat 2
jako zwykłe
pliki. Pozwala to uniknąć problemów, gdyż czytanie plików specjalnych może
mieć nieprzyjemne konsekwencje. Podanie opcji
.Fl s
powoduje, że
.Nm
czyta również argumenty będące plikami specjalnymi urządzeń  blokowych i
znakowych. Jest to przydatne do określania rodzaju systemu plików w
przypadku danych na surowych partycjach dysków, stanowiących pliki specjalne
urządzeń blokowych. Opcja ta powoduje również, że
.Nm
nie zważa na
zgłaszany przez
.Xr stat 2
rozmiar pliku, gdyż w niektórych systemach
funkcja ta zgłasza zero dla surowych partycji dysków.
.It Fl S , Fl Fl no-sandbox
On systems where libseccomp
.Pa ( https://github.com/seccomp/libseccomp )
is available, the
.Fl S
flag disables sandboxing which is enabled by
default.  This option is needed for file to execute external decompressing
programs, i.e. when the
.Fl z
flag is specified and the built-in
decompressors are not available.  On systems where sandboxing is not
available, this option has no effect.
.Pp
.Em Note:
This Debian version of file was built without seccomp support,
so this option has no effect.
.It Fl v , Fl Fl version
Wyświetla informacje o wersji i kończy działanie.
.It Fl z , Fl Fl uncompress
Próbuje zaglądać do plików skompresowanych.
.It Fl Z , Fl Fl uncompress-noreport
Try to look inside compressed files, but report information about the
contents only not the compression.
.It Fl 0 , Fl Fl print0
Wypisuje znak zerowy "\e0" po końcu nazwy plików. Przydatne do zastosowania
.Xr cut 1
na wyniku. Opcja nie wpływa na separator, który jest w dalszym
ciągu wypisywany.
.Pp
If this option is repeated more than once, then
.Nm
prints just the
filename followed by a NUL followed by the description (or ERROR: text)
followed by a second NUL for each entry.
.It Fl -help
Wyświetla komunikat pomocy i wychodzi.
.El
.Sh ŚRODOWISKO
Zmienna środowiskowa
.Ev MAGIC
może być wykorzystana do ustawienia
domyślnej nazwy pliku magicznego. Jeśli zmienna ta jest ustawiona, to
.Nm
nie próbuje otworzyć
.Pa $HOME/.magic .
.Nm
dodaje "\fI.mgc\fP" do
wartości tej zmiennej, jeśli to konieczne. Zmienna środowiskowa
.Ev POSIXLY_CORRECT
kontroluje (w systemach, które obsługuję dowiązania
środowiskowe), czy
.Nm
będzie próbował podążać za dowiązaniami
symbolicznymi. Jeśli jest ustawiona, to
.Nm
podąża za nimi, w przeciwnym
wypadku - nie. Za dowiązania odpowiadają również opcje
.Fl L
i
.Fl h .
.Sh PLIKI
.Bl -tag -width /usr/share/misc/magic.mgc -compact
.It Pa /usr/share/misc/magic.mgc
Domyślna skompilowana lista liczb magicznych.
.It Pa /usr/share/misc/magic
Katalog zawierający domyślne pliki magiczne.
.El
.Sh KOD ZAKOŃCZENIA
.Nm
will exit with
.Dv 0
if the operation was successful or
.Dv >0
if an error was encountered.  The following errors cause diagnostic
messages, but don't affect the program exit code (as POSIX requires), unless
.Fl E
is specified:
.Bl -bullet -compact -offset indent
.It 
A file cannot be found
.It 
There is no permission to read a file
.It 
The file type cannot be determined
.El
.Sh PRZYKŁADY
.Bd -literal -offset indent
$ file file.c file /dev/{wd0a,hda}
file.c:   C program text
file:     ELF 32-bit LSB executable, Intel 80386, version 1 (SYSV),
          dynamically linked (uses shared libs), stripped
/dev/wd0a: block special (0/0)
/dev/hda: block special (3/0)

$ file \-s /dev/wd0{b,d}
/dev/wd0b: data
/dev/wd0d: x86 boot sector

$ file \-s /dev/hda{,1,2,3,4,5,6,7,8,9,10}
/dev/hda:   x86 boot sector
/dev/hda1:  Linux/i386 ext2 filesystem
/dev/hda2:  x86 boot sector
/dev/hda3:  x86 boot sector, extended partition table
/dev/hda4:  Linux/i386 ext2 filesystem
/dev/hda5:  Linux/i386 swap file
/dev/hda6:  Linux/i386 swap file
/dev/hda7:  Linux/i386 swap file
/dev/hda8:  Linux/i386 swap file
/dev/hda9:  empty
/dev/hda10: empty

$ file \-i file.c file /dev/{wd0a,hda}
file.c:      text/x-c
file:        application/x-executable
/dev/hda:    application/x-not-regular-file
/dev/wd0a:   application/x-not-regular-file

.Ed
.Sh ZOBACZ TAKŻE
.Xr hexdump 1 ,
.Xr od 1 ,
.Xr strings 1 ,
.Xr magic 5
.Sh ZGODNOŚĆ ZE STANDARDAMI
.\" URL: http://www.opengroup.org/onlinepubs/009695399/utilities/file.html
Program ten prawdopodobnie wykracza poza definicję FILE(CMD) z definicji
interfejsu Systemu V (System V Interface Definition). Wydaje się tak
przynajmniej z tego, co można zrozumieć z tamtejszego niejasnego
języka... Zachowanie programu jest w większości zgodne z zachowaniem
programu z Systemu V o tej samej nazwie. Wersja niniejsza zna więcej magii,
więc będzie dawała w wielu wypadkach inne (dokładniejsze) wyniki.
.Pp
Jedną z istotnych różnic między tą wersją i wersją z Systemu V, jest to, że
niniejsza wersja traktuje białe znaki jako separatory, więc spacje w
łańcuchach wzorców muszą być chronione. Na przykład,
.Bd -literal -offset indent
\*[Gt]10	string	language impress\ 	(imPRESS data)
.Ed
.Pp
w istniejącym pliku magicznym będzie musiało być zamienione na
.Bd -literal -offset indent
\*[Gt]10	string	language\e impress	(imPRESS data)
.Ed
.Pp
Dodatkowo, w tej wersji, jeśli łańcuch wzorca zawiera odwrotny ukośnik, to
musi być on chroniony. Na przykład
.Bd -literal -offset indent
0	string		\ebegindata	Andrew Toolkit document
.Ed
.Pp
w istniejącym pliku magicznym będzie musiało być zamienione na
.Bd -literal -offset indent
0	string		\e\ebegindata	Andrew Toolkit document
.Ed
.Pp
Wersja 3.2 SunOS i późniejsze pochodzące z Sun Microsystems zawierają
polecenie
.Nm ,
wywodzące się z polecenia z System V, lecz z pewnymi
rozszerzeniami. Ta wersja różni się od Sun-owskiej tylko małymi
szczegółami. Zawiera ona rozszerzenie operatora "\*[Am]", używanego jako np.
.Bd -literal -offset indent
\*[Gt]16	long\*[Am]0x7fffffff	\*[Gt]0		not stripped
.Ed
.Sh BEZPIECZEŃSTWO
On systems where libseccomp
.Pa ( https://github.com/seccomp/libseccomp )
is available,
.Nm
is enforces limiting system calls to only the ones
necessary for the operation of the program.  This enforcement does not
provide any security benefit when
.Nm
is asked to decompress input files
running external programs with the
.Fl z
option.  To enable execution of
external decompressors, one needs to disable sandboxing using the
.Fl S
flag.
.Sh KATALOG MAGICZNY
Wpisy w pliku liczb magicznych pochodzą z wielu źródeł, głównie z USENET-u i
zgłoszone przez różnych autorów. Christos Zoulas (adres poniżej) będzie
zbierał dodatkowe lub poprawione wpisy pliku liczb magicznych. Zebrane wpisy
będą okresowo dystrybuowane.
.Pp
Kolejność wpisów w pliku magicznym jest istotna. Zależnie od używanego
systemu, kolejność, w której są ułożone, może być nieprawidłowa.
.Sh HISTORIA
Polecenie
.Nm
istniało w każdym
.Dv systemie UNIX od przynajmniej wersji Research Version 4
(strona podręcznika man z listopada 1973). Wersja
z Systemu V wprowadziła jedną istotną główną zmianę: zewnętrzną listę typów
liczb magicznych. Spowolniło to trochę program, lecz uczyniło go bardziej
elastycznym.
.Pp
Program ten, oparty na wersji z Systemu V, został napisany przez Iana
Darwina
. Aq ian@darwinsys.com
bez zaglądania do innych źródeł.
.Pp
John Gilmore przerobił mocno ten kod, czyniąc go lepszym niż pierwsza
wersja. Geoff Collyer znalazł kilka nietrafności i dostarczył trochę wpisów
w pliku liczb magicznych. Zmiana obsługi operatora "\*[Am]" przez Roba
McMahona,
.Aq cudcv@warwick.ac.uk ,
w 1989.
.Pp
Guy Harris, guy@netapp.com, wykonał wiele zmian w okresie od 1993 do
dzisiaj.
.Pp
Podstawowy rozwój i konserwację w okresie od 1990 do dzisiaj prowadzi
Christos Zoulas (
.Aq christos@astron.com ) .
.Pp
Zmodyfikowany przez Chrisa Lowtha,
.Aq chris@lowth.com ,
w 2000: Obsługa
opcji
.Fl i
powodującej wyprowadzanie łańcuchów  typów MIME oraz
korzystającej z alternatywnego pliku liczb magicznych i wbudowanej logiki.
.Pp
Zmodyfikowany przez Erica Fischera (
.Aq enf@pobox.com ) ,
w lipcu 2000, aby
rozpoznawał kody znaków i próbował zidentyfikować język plików nie-ASCII.
.Pp
Zmodyfikowany przez Reubena Thomasa
.Aq rrt@sc3d.org ,
w latach 2007-2011,
w celu poprawy obsługi MIME, połączenia magii MIME i nie MIME, obsługi
zarówno katalogów jak i plików magicznych, zaaplikowania wielu poprawek
błędów, zaktualizowania i poprawienia sporej części magii, poprawienia
systemu budowania, dokumentacji i przepisania podpięć Pythona w czystym
Pythonie.
.Pp
Lista osób, które wniosły wkład do katalogu "magic" (pliki magiczne) jest za
długa, aby ją tu przytaczać. Wiecie kim jesteście; dziękujemy. Wiele osób
jest wspomnianych w plikach źródłowych.
.Sh NOTKA PRAWNA
Copyright (c) Ian F. Darwin, Toronto, Canada, 1986-1999. Na standardowej
licencji Berkeley Software Distribution, znajduje się ona w pliku COPYING, w
katalogu źródeł.
.Pp
Pliki
.Pa tar.h
i
.Pa is_tar.c
zostały napisane przez Johna Gilmore'a,
a pochodzą z jego ogólnie dostępnego programu
.Xr tar 1
i nie podlegają
powyższej licencji.
.Sh BŁĘDY
Proszę zgłaszać błędy i wysyłać łatki do systemu śledzenia błędów pod
adresem
.Pa http://bugs.astron.com/
lub na listę dyskusyjną
.Aq file@astron.com
(najpierw proszę się zapisać na
.Pa https://mailman.astron.com/mailman/listinfo/file ) .
.Sh DO ZROBIENIA
Naprawić wyjście, dzięki czemu testy flag MIME i APPLE nie będą potrzebne
wszędzie, a rzeczywiste wyjście byłoby tworzone tylko raz w jednym
miejscu. Wymaga odpowiedniego projektu. Sugestia: wypychaj prawdopodobne
wyniki na listę i użyj ostatniej wartości z listy (powinna być
najdokładniejsza) lub użyj wartości domyślnej, jeśli lista jest pusta. Nie
powinno to spowolnić obliczeń.
.Pp
The handling of
.Dv MAGIC_CONTINUE
and printing \e012- between entries is
clumsy and complicated; refactor and centralize.
.Pp
Some of the encoding logic is hard-coded in encoding.c and can be moved to
the magic files if we had a !:charset annotation
.Pp
Kontynuować likwidację wszystkich błędów. System BTS Debiana jest tu dobrym
źródłem.
.Pp
Store arbitrarily long strings, for example for %s patterns, so that they
can be printed out.  Fixes Debian bug #271672.  This can be done by
allocating strings in a string pool, storing the string pool at the end of
the magic file and converting all the string pointers to relative offsets
from the string pool.
.Pp
Dodać składnię do względnych przesunięć po bieżącym poziomie (bug Debiana
#466037).
.Pp
Sprawić, by działała opcja -ki, tzn. podawanie wielu typów MIME.
.Pp
Add a zip library so we can peek inside Office2007 documents to print more
details about their contents.
.Pp
Dodać opcję do wypisywania URL-i źródeł opisów plików.
.Pp
Połączyć przeszukiwania skryptów i dodać metodę na powiązanie nazw plików
wykonywalnych z typami MIME (wartość magiczna do !:mime która spowodowałaby
wyszukanie wynikowego łańcucha w tabeli). Dzięki temu uniknęłoby się
dodawanie tych samych wartości magicznych dla każdego nowego interpretera
hash-bang.
.Pp
When a file descriptor is available, we can skip and adjust the buffer
instead of the hacky buffer management we do now.
.Pp
Naprawić
.Dq name
i
.Dq use
aby pilnowały spójności w chwili
kompilacji (zduplikowane
.Dq name ,
.Dq use
wskazujące na
niezdefiniowaną
.Dq name ) .
.Dq name
/
.Dq use
powinny być
efektywniejsze poprzez utrzymywanie posortowanej listy nazw. Wdrożyć i
udokumentować ^ jako specjalny przypadek do zmieniania kolejności bajtów w
parserze, dzięki czemu nie wymagałoby to cytowania.
.Pp
If the offsets specified internally in the file exceed the buffer size (
.Dv HOWMANY
variable in file.h), then we don't seek to that offset, but
we give up.  It would be better if buffer managements was done when the file
descriptor is available so move around the file.  One must be careful though
because this has performance (and thus security considerations).
.Sh DOSTĘPNOŚĆ
Najnowszą oryginalną wersję programu tego autora można pobrać z anonimowego
ftp z
.Pa ftp.astron.com ,
z katalogu
.Pa /pub/file/file-X.YZ.tar.gz .

.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Przemek Borys <pborys@dione.ids.pl>,
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>
i
Michał Kułach <michal.kulach@gmail.com>
.

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres
.MT
manpages-pl-list@lists.sourceforge.net
.ME .
