NAZWA¶

config - biblioteka plik��w konfiguracyjnych OpenSSL CONF

OPIS¶

Uwaga! To tłumaczenie może być nieaktualne! Biblioteka OpenSSL CONF sÄšÂ�uĚźy do wczytywania plikÄ�Ĺ�w konfiguracyjnych. ObsÄšÂ�uguje gÄšÂ�Ä�Ĺ�wny plik konfiguracyjny OpenSSL openssl.cnf oraz kilka innych, jak na przykÄšÂ�ad pliki SPKAC i pliki rozszerzenia certyfikatÄ�Ĺ�w dla narzĂ�Â�dzi x509. Plik konfiguracyjny jest podzielony na sekcje. KaĚźda z nich rozpoczyna siĂ�Â� wierszem [ nazwa_sekcji ] i koÄšÂ�czy wraz z poczĂ�Â�tkiem nastĂ�Â�pnej sekcji lub wraz z koÄšÂ�cem pliku. Nazwa sekcji moĚźe siĂ�Â� skÄšÂ�adaĂ�Â� ze znakÄ�Ĺ�w alfanumerycznych oraz znakÄ�Ĺ�w podkreÄšÂ�lenia. Pierwsza sekcja pliku konfiguracyjnego ma specjalne znaczenie i okreÄšÂ�lana jest jako sekcja domyÄšÂ�lna. Zwykle nie ma nazwy i znajduje siĂ�Â� na poczĂ�Â�tku pliku, przed pierwszĂ�Â� nazwanĂ�Â� sekcjĂ�Â�. Nazwy sĂ�Â� wyszukiwane najpierw w nazwanych sekcjach (o ile takie sĂ�Â�), a nastĂ�Â�pnie w sekcji domyÄšÂ�lnej. ÄšÂ�rodowisko jest mapowane na sekcjĂ�Â� o nazwie ENV. Komentarze naleĚźy poprzedzaĂ�Â� znakiem #. KaĚźda sekcja pliku konfiguracyjnego skÄšÂ�ada siĂ�Â� z par nazwa/wartoÄšÂ�Ă�Â� w formie nazwa=wartoÄšÂ�Ă�Â�. ÄšÂ�aÄšÂ�cuch nazwa moĚźe zawieraĂ�Â� dowolne znaki alfanumeryczne jak rÄ�Ĺ�wnieĚź niektÄ�Ĺ�re znaki przestankowe, takie jak . , ; oraz _. ÄšÂ�aÄšÂ�cuch wartoÄšÂ�Ă�Â� skÄšÂ�ada siĂ�Â� z ciĂ�Â�gu znakÄ�Ĺ�w pomiĂ�Â�dzy znakiem = a koÄšÂ�cem wiersza, z wyÄšÂ�Ă�Â�czeniem wszelkich spacji poprzedzajĂ�Â�cych oraz koÄšÂ�cowych. ÄšÂ�aÄšÂ�cuch wartoÄšÂ�ci podlega przesÄšÂ�anianiu zmiennych. Robi siĂ�Â� to poprzez uĚźycie formy $zmienna lub ${zmienna}: zastĂ�Â�puje to wartoÄšÂ�Ă�Â� nazwanej zmiennej w bieĚźĂ�Â�cej sekcji. MoĚźna takĚźe zastĂ�Â�piĂ�Â� wartoÄšÂ�Ă�Â� z innej sekcji przy uĚźyciu formy $sekcja::nazwa lub ${sekcja::nazwa}. Zmienne ÄšÂ�rodowiskowe przesÄšÂ�ania siĂ�Â� za pomocĂ�Â� konstrucji ENV::nazwa. W ten sam sposÄ�Ĺ�b moĚźna takĚźe definiowaĂ�Â� zmienne ÄšÂ�rodowiskowe, jeÄšÂ�li tylko program wyszukuje je za poÄšÂ�rednictwem biblioteki CONF zamiast bezpoÄšÂ�redniego wywoÄšÂ�ania getenv(). MoĚźna cytowaĂ�Â� poszczegÄ�Ĺ�lne znaki poprzez dowolny znak cytowania lub znak \. Przez postawienie znaku \ na koÄšÂ�cu wiersza ÄšÂ�aÄšÂ�cuch wartoÄšÂ�Ă�Â� moĚźna rozciĂ�Â�gaĂ�Â� na kilka wierszy. TĂ�Â� samĂ�Â� rolĂ�Â� peÄšÂ�niĂ�Â� teĚź sekwencje \n, \r, \b oraz \t.

UWAGI¶

Je̟eli plik konfiguracyjny stara si�� przes�oni�� nieistniej��c�� zmienn��, podnoszony jest znacznik b���du i plik nie zostaje wczytany. Mo̟e si�� to sta�� podczas pr��by przes�aniania nie zdefiniowanej zmiennej �rodowiskowej. Na przyk�ad domy�lny plik konfiguracji OpenSSL u̟ywa� warto�ci HOME, kt��ra mo̟e nie istnie�� w systemach innych ni̟ uniksy. Mo̟na to obej��� za pomoc�� sekcji domy�lnej, w kt��rej znajd�� si�� domy�lne warto�ci: je̟eli w�rod zmiennych �rodowiska nie znajdzie si�� danej warto�ci, zostanie u̟yta w�a�nie warto��� domy�lna. Aby ten spos��b dzia�a� w�a�ciwie, warto��� domy�lna musi zosta�� zdefiniowana w pliku wcze�niej ni̟ przes�oni��cie. Przyk�ad��w poszukaj w sekcji PRZYK�ADY. Je�li ta sama warto��� jest zdefiniowana wi��cej ni̟ jeden raz, wszystkie wyst��pienia poza ostatnim zostan�� pomini��te bez komunikatu o b���dzie. W sytuacjach takich jak DN to samo pole mo̟e si�� pojawi�� wielokrotnie - rozwi��zaniem jest zwykle pomijanie znak��w przed pocz��tkow�� ., na przyk�ad:

 1.OU="Moje pierwsze OU"
 2.OU="Moje Drugie OU"

PRZYKÄšÂ�ADY¶

Oto przyk�adowy plik konfiguracyjny zawieraj��cy niekt��re z wymienionych wy̟ej element��w:

 # To jest sekcja domy�lna.

 HOME=/temp
 RANDFILE= ${ENV::HOME}/.rnd
 configdir=$ENV::HOME/config

 [ sekcja_pierwsza ]

 # Jeste�my w pierwszej sekcji.

 # Cytowanie pozwala na u̟ywanie spacji poprzedzaj��cych i ko�cowych
 cokolwiek = " dowolna nazwa zmiennej "

 tekst = �a�cuch kt��ry mo̟e \
 rozci��ga�� si�� na kilka wierszy \
 przy u̟yciu \\ na ko�cu wiersza

 komunikat = Witaj �wiecie\n

 [ sekcja_druga ]

 pozdrowienia = $sekcja_pierwsza::komunikat

Nast��pny przyk�ad pokazuje jak bezpiecznie przes�ania�� zmienne �rodowiskowe. Za���̟my, ̟e chcemy aby zmienna tmpfile wskazywa�a nazw�� pliku roboczego. Katalog, w kt��rym ten plik si�� znajduje, mo̟na odczyta�� ze zmiennych �rodowiskowych TEMP lub TMP, lecz mog�� one nawet nie mie�� nadanej ̟adnej warto�ci. Je�li po prostu u̟yjemy nazw zmiennych �rodowiskowych i oka̟e si��, ̟e one nie istniej��, to podczas pr��by otwarcia pliku wyst��pi b���d. Przy wykorzystaniu sekcji domy�lnej mo̟emy spowodowa��, ̟e najpierw b��dzie poszukiwana zmienna TEMP, nast��pnie TMP, a je�li ̟adna z nich nie b��dzie zdefiniowana, zostanie u̟yty katalog /tmp.

 TMP=/tmp
 # Powy̟sza warto��� jest u̟ywana kiedy TMP nie ma w �rodowisku
 TEMP=$ENV::TMP
 # Powy̟sza warto��� jest u̟ywana kiedy TEMP nie ma w �rodowisku
 tmpfile=${ENV::TEMP}/tmp.filename

BÄšÂ�Ă�Â�DY¶

W obecnej chwili nie ma sposobu na wykorzystanie znak��w w zapisie ��semkowym \nnn. Wszystkie �a�cuchy s�� zako�czone znakiem braku informacji, wi��c te znaki nie mog�� pojawiac si�� w warto�ciach. Cytowanie nie jest ca�kiem porz��dne: po u̟yciu sekwencji w rodzaju \n nie mo̟na wi��cej u̟ywa�� cytowania w tym samym wierszu. Pliki s�� wczytywane tylko w jednym przebiegu. Z tego powodu przes�anianie zmiennych dzia�a tylko je̟eli s�� one zdefiniowane we wcze�niejszych wierszach danego pliku.

ZOBACZ TAKĚżE¶

x509(1), req(1), ca(1)

OD TÄšÂ�UMACZA¶

T�umaczenie Daniel Ko�� <kocio@linuxnews.pl> na podstawie strony podr��cznika systemowego config(1) 0.9.6c, 15.04.2002.

INFORMACJE O TŁUMACZENIU¶

Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

man --locale=C 5ssl config

Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.