dir_colors(5) File Formats Manual dir_colors(5) NAZWA dir_colors - plik konfiguracyjny dircolors(1) OPIS Program ls(1) korzysta ze zmiennej srodowiskowej LS_COLORS do okreslenia kolorow uzywanych do wyswietlania nazw plikow. Zmienna srodowiskowa jest zwykle ustawiana przez polecenie takie jak eval `dircolors jakas_sciezka/dir_colors` w pliki inicjujacym domyslna powloke systemowa, jak /etc/profile lub /etc/csh.cshrc (zob. tez dircolors(1)). Uzywanym tu plikiem jest zwykle /etc/DIR_COLORS, ktory mozna przeslonic plikiem .dir_colors w katalogu domowym danego uzytkownika. Plik konfiguracyjny sklada sie z wielu wyrazen, po jednym na wiersz. Wszystko co znajduje sie na prawo od znaku kratki (#) jest traktowane jako komentarz, jesli znak ten znajduje sie na poczatku wiersza i nastepuje za nim co najmniej jedna spacja. Puste wiersze sa ignorowane. Sekcja global pliki sklada sie ze wyrazen, ktore znajduja sie przed pierwszym wyrazeniem TERM. Wszelkie wyrazenia w sekcji global pliki sa uwazane jako prawidlowe dla wszystkich typow terminali. Po sekcji global wystepuje jedna lub wiecej sekcji wlasciwych dla konkretnego terminala, poprzedzonych przez jedno lub wiecej wyrazen TERM okreslajacych typy terminali (jak podawanych przez zmienna srodowiskowa TERM), po ktorych nastepuja wlasciwe im deklaracje. Deklaracje globalna zawsze da sie przeslonic przez kolejna deklaracje wlasciwa dla konkretnego terminala. Rozpoznawane sa nastepujace wyrazenia; wielkosc znakow nie ma znaczenia: TERM typ-terminala Zaczyna sekcje wlasciwa dla konkretnego terminala i okresla, do ktorego terminala sie ona odnosi. Mozna podac wiele wyrazen TERM, aby utworzyc sekcje stosujaca sie do wielu typow terminali. COLOR yes|all|no|none|tty (tylko Slackware; ignorowane przez GNU dircolors(1)) Okresla, ze kolorowanie powinno byc zawsze wlaczone (yes lub all), nigdy nie wlaczone (no lub none) lub wlaczone tylko, gdy wyjsciem jest terminal (tty). Wartosc domyslna to no. EIGHTBIT yes|no (tylko Slackware; ignorowane przez GNU dircolors(1)) Okresla, ze osmiobitowe znaki ISO/IEC 8859 powinny byc domyslnie wlaczone. Ze wzgledu na kompatybilnosc, mozna podac rowniez 1 jako yes lub 0 jako no. Wartosc domyslna to no (wylaczone). OPTIONS opcje (tylko Slackware; ignorowane przez GNU dircolors(1)) Dodaje opcje wiersza polecen do domyslnego wiersza polecenia ls. Opcjami moga byc dowolne prawidlowe opcje wiersza polecen ls i powinno sie je podac wraz z rozpoczynajacym znakiem minus. Prosze zauwazyc, ze dircolors nie weryfikuje prawidlowosci tych opcji. NORMAL sekwencja-koloru Okresla kolor uzywany przez zwykly (niebedacy nazwa pliku) tekst. Synonim: NORM. FILE sekwencja-koloru Okresla kolor uzywany do zwyklego pliku. DIR sekwencja-koloru Okresla kolor uzywany do katalogow. LINK sekwencja-koloru Okresla kolor uzywany do dowiazania symbolicznego. Synonimy: LNK, SYMLINK. ORPHAN sekwencja-koloru Okresla kolor uzywany do zerwanego dowiazania symbolicznego (wskazujacego na nieistniejacy plik). Jesli wartosc ta nie bedzie okreslona, ls w takim przypadku uzyje koloru LINK. MISSING sekwencja-koloru Okresla kolor uzywany do brakujacego pliku (nieistniejacego pliku, na ktory jednak wskazuje dowiazanie symboliczne). Jesli wartosc ta nie bedzie okreslona, ls w takim przypadku uzyje koloru FILE. FIFO sekwencja-koloru Okresla kolor uzywany do FIFO (nazwanego potoku). Synonim: PIPE. SOCK sekwencja-koloru Okresla kolor uzywany do gniazda. DOOR sekwencja-koloru (Obslugiwane od fileutils 4.1) Okresla kolor uzywany do pliku door (Solaris 2.5 i pozniejsze). BLK sekwencja-koloru Okresla kolor uzywany do pliku specjalnego urzadzenia blokowego. Synonim: BLOCK. CHR sekwencja-koloru Okresla kolor uzywany do pliku specjalnego urzadzenia znakowego. Synonim: CHAR. EXEC sekwencja-koloru Okresla kolor uzywany do pliku z ustawionym atrybutem wykonania. SUID sekwencja-koloru Okresla kolor uzywany do pliku z ustawionym atrybutem ustawienia identyfikatora uzytkownika podczas wykonania (SUID). Synonim: SETUID. SGID sekwencja-koloru Okresla kolor uzywany do pliku z ustawionym atrybutem ustawienia identyfikatora grupy podczas wykonania (SGID). Synonim: SETGID. STICKY sekwencja-koloru Okresla kolor uzywany do katalogu z ustawionym atrybutem bitu lepkosci. STICKY_OTHER_WRITABLE sekwencja-koloru Okresla kolor uzywany do katalogu zapisywalnego dla innych, z ustawionym atrybutem wykonania. Synonim: OWT. OTHER_WRITABLE sekwencja-koloru Okresla kolor uzywany do katalogu zapisywalnego dla innych, bez ustawionego atrybutu wykonania. Synonim: OWR. LEFTCODE sekwencja-koloru Okresla lewy kod do terminali innych niz ISO/IEC 6429 (zob. nizej). Synonim: LEFT. RIGHTCODE sekwencja-koloru Okresla prawy kod do terminali innych niz ISO/IEC 6429 (zob. nizej). Synonim: RIGHT. ENDCODE sekwencja-koloru Okresla kod koncowy do terminali innych niz ISO/IEC 6429 (zob. nizej). Synonim: END. *rozszerzenie sekwencja-koloru Okresla kolor uzywany przez wszystkie pliki konczace sie rozszerzeniem. .rozszerzenie sekwencja-koloru Jak *.rozszerzenie. Okresla kolor uzywany przez wszystkie pliki konczace sie rozszerzeniem. Prosze zauwazyc, ze kropka jest czescia rozszerzenia, zatem nie da sie podac rozszerzenia niezaczynajacego sie kropka, takiego jak pliki kopii zapasowej ~ programu emacs. Te postac nalezy uwazac za przestarzala. Sekwencje kolorow ISO/IEC 6429 (ANSI) Wiekszosc dzisiejszych terminali ASCII z mozliwoscia wyswietlania kolorow uzywa sekwencji kolorow ISO/IEC 6429 (ANSI), a wiele popularnych terminali niekolorowych, w tym xterm i czesto spotykany i klonowany DEC VT100, rozpoznaje kody kolorow ISO/IEC 6429 i bezbolesnie eliminuje je z wyjscia lub emuluje je. ls uzywa domyslnie kodow ISO/IEC 6429 o ile kolorowanie jest wlaczone. Kody kolorow ISO/IEC 6429 skladaja sie z sekwencji liczb rozdzielonych dwukropkiem. Najpopularniejsze kody to: 0 przywraca kolor domyslny 1 rozjasnia kolory 4 podkresla tekst 5 tworzy tekst migajacy 30 czarny tekst (pierwszy plan) 31 czerwony tekst 32 zielony tekst 33 zolty (lub brazowy) tekst 34 niebieski tekst 35 fioletowy tekst 36 blekitny tekst 37 bialy (lub szary) tekst 40 czarne tlo 41 czerwone tlo 42 zielone tlo 43 zolte (lub brazowe) tlo 44 niebieskie tlo 45 fioletowe tlo 46 blekitne tlo 47 biale (lub szare) tlo Nie wszystkie polecenia zadzialaja na wszystkich systemach lub urzadzeniach. ls uzywa nastepujacych wartosci domyslnych: NORMAL 0 Zwykly tekst (niebedacy nazwa pliku) FILE 0 Zwykly plik DIR 32 Katalog LINK 36 Dowiazanie symboliczne ORPHAN niezdefiniowane Zerwane dowiazanie symboliczne MISSING niezdefiniowane Brakujacy plik FIFO 31 Potok nazwany (FIFO) SOCK 33 Gniazdo BLK 44;37 Urzadzenie blokowe CHR 44;37 Urzadzenie znakowe EXEC 35 Plik wykonywalny Kilka programow nie rozpoznaje poprawnie wartosci domyslnych. Jesli po wypisaniu zawartosci katalogu caly tekst pozostaje kolorowany, nalezy zmienic kody NORMAL i FILE na numeryczne kody stosowanych zwyklych kolorow tekstu i tla. Inne typy terminali (konfiguracja zaawansowana) Jesli posiada sie terminal (albo drukarke!) kolorowy (lub stosujacy podswietlenie), ktory korzysta z innego zestawu kodow, wciaz mozna utworzyc odpowiednie ustawienia. W tym celu trzeba bedzie uzyc definicji LEFTCODE, RIGHTCODE i ENDCODE. Przy wypisywaniu nazwy pliku, ls tworzy nastepujace sekwencje wyjsciowe: LEFTCODE kod-od-typu RIGHTCODE nazwa-pliku ENDCODE, gdzie kod-od-typu jest sekwencja koloru zalezna od typu lub nazwy pliku. Jesli ENDCODE jest niezdefiniowany, w zamian bedzie uzywana sekwencja LEFTCODE NORMAL RIGHTCODE. Przeznaczeniem lewego i prawego kodu jest tylko ograniczenie wielkosci wpisywanego tekstu (i ukrycie nieestetycznych sekwencji specjalnych przed uzytkownikiem). Jesli nie sa one wymagane przez uzywany terminal, mozna je wyeliminowac, wpisujac samodzielnie dane slowo kluczowe w wierszu. UWAGA: Jesli w globalnej sekcji pliku konfiguracyjnego zdefiniowano ENDCODE, nie da sie usunac tej definicji w sekcji wlasciwej dla danego terminala. Oznacza to, ze definicje NORMAL wowczas nie zadzialaja. Mozna jednak podac rozne ENDCODE, co da ten sam efekt. Sekwencje specjalne Aby w sekwencjach kolorow lub rozszerzen nazw plikow podac znaki sterujace lub odstepy, mozna zastosowac notacje specjalna jezyka C stosujaca \ lub notacje specjalna stty stosujaca ^-. Notacja jezyka C obejmuje ponizsze znaki: \a Dzwonek (ASCII 7) \b Backspace (ASCII 8) \e Escape (ASCII 27) \f Wysuw strony (ASCII 12) \n Nowy wiersz (ASCII 10) \r Powrot karetki (ASCII 13) \t Tabulator (ASCII 9) \v Tabulator pionowy (ASCII 11) \? Delete (ASCII 127) \nnn Dowolny znak (notacja osemkowa) \xnnn Dowolny znak (notacja szesnastkowa) \_ Spacja \\ Odwrotny ukosnik (\) \^ Kareta (^) \a Znak kratki (#) Prosze zauwazyc, ze sekwencje specjalne sa konieczne do podania spacji, odwrotnego ukosnika, karety lub dowolnych znakow sterujacych w lancuchu, jak rowniez znaku kratki jako pierwszego znaku. PLIKI /etc/DIR_COLORS Ogolnosystemowy plik konfiguracyjny. ~/.dir_colors Plik konfiguracyjny uzytkownika. Niniejsza strona podrecznika systemowego opisuje format pliku dir_colors uzywany przez pakiet fileutils-4.1; inne wersje moga sie nieco roznic. UWAGI Domyslne definicje LEFTCODE i RIGHTCODE uzywane przez terminale ISO/IEC 6429 to: LEFTCODE \e[ RIGHTCODE m Domyslnie ENDCODE jest niezdefiniowany. ZOBACZ TAKZE dircolors(1), ls(1), stty(1), xterm(1) TLUMACZENIE Tlumaczenie niniejszej strony podrecznika: Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.15 17 maja 2025 r. dir_colors(5)