.\" -*- coding: UTF-8 -*- .\" $File: file.man,v 1.151 2024/04/07 21:27:35 christos Exp $ .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .Dd 7 kwietnia 2024 r. .Dt FILE 1 .Os .Sh NAZWA .Nm file .Nd określa typ pliku .Sh SKŁADNIA .Nm file .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 file .Fl C .Op Fl m Ar pliki-magiczne .Nm file .Op Fl Fl help .Sh OPIS Niniejsza strona podręcznika dokumentuje wersję 5.46 polecenia .Nm . .Pp .Nm file 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 modyfikacji plików magicznych lub samego programu, proszę .Em zachować te słowa kluczowe . Wielu polega na tym, że dla wszystkich czytelnych plików wypisywane jest słowo \[Bq]text\[rq]. Nie należy więc robić tego, co zrobiono w Berkeley - zmieniono tam \[Bq]shell commands text\[rq] na \[Bq]shell script\[rq]. .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ą \[Bq]liczby magiczne\[rq] 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 \[Bq]liczb magicznych\[rq] 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/file/misc/magic.mgc lub z katalogu .Pa /usr/share/file/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 \[Bq]text\[rq], gdyż mogą być one na ogół czytane na dowolnym terminalu; pliki w UTF-16 i EBCDIC stanowią jedynie \[Bq]character data\[rq] (dane znakowe), gdyż jeśli zawierają one tekst, tekst ten wymaga przed przeczytaniem konwersji. Dodatkowo, .Nm file 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 file 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 \[Bq]data\[rq] (dane). .Sh OPCJE .Bl -tag -width indent .It Fl Fl apple Powoduje, że polecenie .Nm 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 opcją .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 \[Bq]encoding\[rq]). .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 simh Sprawdza pliki taśm SIMH. .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 \[Bq]ascii\[rq]. .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 \[Bq]:\[rq]. .It Fl f , Fl Fl files-from 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 \[Bq]-\[rq] 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. \[Bq] .Fl F Ar @ Fl f Ar nazwa-pliku \[rq], zamiast: \[Bq] .Fl f Ar nazwa-pliku Fl F Ar @ \[rq]. .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 .Nm file wypisuje łańcuchy typów mime, zamiast tradycyjnych nazw czytelnych dla użytkownika. Stąd, pojawić się może \[Bq]text/plain; charset=us-ascii\[rq], zamiast \[Bq]ASCII text\[rq]. .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 \[Bq]\[rs]012\- \[rq] (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 Opcja 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 magic-file 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 file 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 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX .It Sy Nazwa Ta Sy Domyślnie Ta Sy Opis .It Li bytes Ta 1M 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 2K Ta maks. liczba przetw. sekcji programu ELF .It Li elf_shnum Ta 32K Ta maks. liczba przetw. sekcji ELF .It Li elf_shsize Ta 128MB Ta maks. liczba przetw. rozm. sekcji ELF .It Li encoding Ta 65K Ta maks. liczba bajtów do rozpozn. kodowania .It Li indir Ta 50 Ta limit rekurencji dla magii niebezpośr. .It Li name Ta 100 Ta limit dla name/use magii .It Li regex Ta 8K 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 file tłumaczy znaki niedrukowalne na ich postać ósemkową. .It Fl s , Fl Fl special-files Normalnie, .Nm file 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 file 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 file 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 W systemach, w których dostępna jest biblioteka libseccomp .Pa ( https://github.com/seccomp/libseccomp ) , opcja .Fl S wyłącza piaskownicę, która domyślnie jest włączona. Opcja ta jest wymagana, aby .Nm file wykonywał zewnętrzne programy dekompresujące tj. gdy poda się opcję .Fl z , a wbudowane dekompresory są niedostępne. W systemach, w których piaskownica jest niedostępna, opcja ta nie ma znaczenia. .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 Próbuje zaglądać do plików skompresowanych, ale informuje tylko o zawartości, nie o kompresji. .It Fl 0 , Fl Fl print0 Wypisuje znak null \[Bq]\e0\[rq] 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 Jeśli opcję tę poda się więcej niż raz, .Nm file wypisze dla każdego wpisu jedynie: nazwę pliku, następnie NUL, następnie opis (lub tekst ERROR:), następnie drugi NUL. .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 file nie próbuje otworzyć .Pa $HOME/.magic . .Nm file dodaje \[Bq]\fI.mgc\fP\[rq] 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 file będzie próbował podążać za dowiązaniami symbolicznymi. Jeśli jest ustawiona, to .Nm file 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/file/misc/magic.mgc -compact .It Pa /usr/share/file/misc/magic.mgc Domyślna skompilowana lista liczb magicznych. .It Pa /usr/share/file/misc/magic Katalog zawierający domyślne pliki magiczne. .El .Sh STATUS ZAKOŃCZENIA .Nm file wyjdzie z .Dv 0 , jeśli operacja była pomyślna lub .Dv >0 , gdy wystąpił błąd. Następujące błędy powodują wyświetlenie komunikatów diagnostycznych, jednak nie zmieniają kodu zakończenia programu (jak wymaga tego POSIX), chyba że podano .Fl E : .Bl -bullet -compact -offset indent .It Nie można odnaleźć pliku .It Brak uprawnień do odczytu pliku .It Nie można rozpoznać typu pliku .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 file , 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 \[Bq]\*[Am]\[rq], używanego jako np. .Bd -literal -offset indent \*[Gt]16 long\*[Am]0x7fffffff \*[Gt]0 not stripped .Ed .Sh BEZPIECZEŃSTWO W systemach, w których dostępna jest biblioteka libseccomp .Pa ( https://github.com/seccomp/libseccomp ) , .Nm file ogranicza wywołania systemowe tylko do ściśle niezbędnych do działania programu. Gdy .Nm file ma rozpakować pliki wejściowe za pomocą zewnętrznych programów, po podaniu opcji .Fl z , to ograniczenie nie daje żadnych korzyści związanych z bezpieczeństwem. Aby pozwolić na wykonywanie zewnętrznych dekompresorów, konieczne jest wyłączenie piaskownicy za pomocą opcji .Fl S . .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. Jest stare polecenie .Nm file korzystało z pliku magicznego, należy go zachować do celów porównawczych (proszę zmienić jego nazwę na .Pa /usr/share/file/misc/magic.orig ) . .Sh HISTORIA Polecenie .Nm file 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 \[Bq]\*[Am]\[rq] 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 \[Bq]magic\[rq] (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 USTERKI 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 Obsługa .Dv MAGIC_CONTINUE i wypisywanie \e012- pomiędzy pozycjami jest niezręczne i skomplikowane: dokonać refaktoryzacji i centralizacji. .Pp Część logiki kodowania jest zapisana na sztywno w encoding.c i mogłaby być przeniesiona do plików magicznych, gdyby istniała notacja !:zestaw-znaków. .Pp Kontynuować likwidację wszystkich błędów. System BTS Debiana jest tu dobrym źródłem. .Pp Przechowywać dowolnie długie łańcuchy, np. dla %s wzorców, dzięki czemu mogłyby być wypisywane. Naprawia błąd Debiana #271672. Można to zrobić przydzielając łańcuchy do puli łańcuchów, przechowując pulę łańcuchów na końcu pliku magicznego i konwertując wszystkie wskaźniki łańcuchów na względne przesunięcia z puli łańcuchów. .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 Dodać bibliotekę zip do zagłębienia się w dokumenty Office2007, co umożliwiłoby wypisanie większej ilości szczegółów na temat ich zawartości. .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 Gdy dostępny jest deskryptor plików, można by było pominąć i dostosować bufor, zamiast dokonywać prowizorycznego zarządzania buforem, jak ma to miejsce obecnie. .Pp Naprawić \[Bq]name\[rq] i \[Bq]use\[rq] aby pilnowały spójności w chwili kompilacji (zduplikowane \[Bq]name\[rq], \[Bq]use\[rq] wskazujące na niezdefiniowaną \[Bq]name\[rq]). \[Bq]name\[rq] / \[Bq]use\[rq] 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 Jeśli przesunięcia określone wewnętrznie w pliku wykraczają poza rozmiar bufora (zmienna .Dv HOWMANY w file.h), nie należy próbować tego przesuwania, lecz należy zaniechać operacji. Działałoby to lepiej, gdyby zarządzanie buforem było dokonywane, gdy dostępny jest deskryptor pliku, dzięki czemu można by przemieszczać się po pliku. Należy być jednak ostrożnym, ponieważ niesie to pewne konsekwencje dotyczące wydajności, a co za tym idzie bezpieczeństwa, ponieważ można spowolnić działanie dokonując powtarzającego się przemieszczania. .Pp Obecnie istnieje obsługa utrzymywania oddzielnych buforów oraz przesunięć z końca pliku, lecz wewnętrzne zarządzanie buforem wciąż wymaga przeprojektowania. .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 . .Pp .Sh TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Przemek Borys , Andrzej Krzysztofowicz i Michał Kułach . .Pp Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .Lk https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .Pp Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .Mt manpages-pl-list@lists.sourceforge.net .Me .