NAZWA

makemap — tworzy bazy map dla smtpd

SKŁADNIA

makemap [-U] [-d typ-b-d] [-o plik-b-d] [-t typ] plik

OPIS

Maps udostępnia ogólny interfejs do wiązania klucza tekstowego z wartością. Dostęp do takich powiązań może następować za pomocą zwykłego pliku tekstowego, bazy danych lub DNS. Format tych typów plików opisano poniżej. Sam makemap tworzy mapy baz danych za pomocą powiązań wyszukiwań z kluczem określonych w smtpd.conf(5).

makemap odczytuje wejście z pliku i zapisuje dane do pliku, którego nazwa powstaje przez dodanie do pliku przyrostka „.db”. Bieżący wiersz może być kontynuowany w kolejnych wiersza za pomocą ukośnika „\”. Komentarze można umieszczać gdziekolwiek w pliku, za pomocą znaku kratki „#” i sięgają końca bieżącego wiersza. Należy uważać przy komentowaniu tekstu wielowierszowego, gdy komentarz kończy się na końcu całego bloku. We wszystkich przypadkach, makemap odczytuje wiersze składające się ze słów oddzielonych znakiem białej spacji. Pierwszym słowem w wierszu jest klucz bazy danych, pozostała część reprezentuje przypisaną wartość. Klucz i wartość bazy danych można opcjonalnie rozdzielić dwukropkiem.

Dostępne są następujące opcje:

-d typ-b-d

Określa format bazy danych. Dostępne formaty to: hash oraz btree. Domyślną wartością jest hash.

-o plik-b-d

Zapisuje utworzoną bazę danych do pliku-b-d.

-t typ

Określa format wynikowego pliku mapy. Domyślny format mapy jest odpowiedni do przechowywania prostych łańcuchów, nieposiadających struktury, powiązanych w sposób „klucz do wartości”. Jeśli jednak wiązana wartość ma specjalne znaczenie, jak ma to miejsce w pliku domen wirtualnych, konieczne jest podanie odpowiedniego typu. Dostępne typy wyjściowe to:

aliases

Wiązana wartość jest listą odbiorców poczty, rozdzielonych przecinkiem. Format ten może służyć do budowania aliasów i przypisań użytkowników w przypadku plików domen wirtualnych.

set

Brak jest przypisywanych wartości – mapy tego typu pozwalają na wyszukiwanie jedynie samych kluczy. Format może służyć do budowania map domen podstawowych.

-U

Zamiast generować mapę bazę danych z wejścia tekstowego, zrzuca zawartość mapy bazy danych jako tekst, gdzie klucz i wartość są rozdzielone tabulatorem.

DOMENY POSTAWOWE

Domeny podstawowe można przechowywać w tablicach. Aby utworzyć tablicę podstawowych domen, należy dodać każdą domenę podstawową jako pojedynczy wiersz.

Oprócz dodawania wpisów dla powiązań domen podstawowych, należy dodać regułę filtrowania, która akceptuje pocztę dla powiązań domeny na przykład:

table domains db:/etc/smtpd/domains.db

action "local" mbox

dla domeny <domains> dopasowuje akcję "local"

DOMENY WIRTUALNE

Domeny wirtualne również można przechowywać w tablicach. Aby utworzyć tablicę domen wirtualnych, należy dodać każdą domenę wirtualną jako pojedynczy wiersz.

Domeny wirtualne oczekują przypisania użytkowników wirtualnych do użytkowników rzeczywistych, aby określić, czy odbiorca ma być zaakceptowany, czy też nie. Format przypisania jest rozszerzeniem aliases(5), co pozwala korzystania z „user@domain.tld” aby akceptować użytkowników tylko w określonej domenie, „user” aby akceptować użytkowników dla dowolnej z domen wirtualnych, „@domain.tld” aby przechwycić konkretną domenę i „@” aby przechwycić wszystkich dla wszystkich domen. smtpd(8) wykona przeszukiwania w tej, podanej kolejności.

Aby utworzyć pojedynczy adres wirtualny, należy dodać „user@example.com user” do mapy użytkowników. Aby obsłużyć całą pocztę skierowaną do dowolnego użytkownika w example.com, należy dodać „@example.com user” do mapy wirtualnej.

Oprócz dodawania wpisów dla mapy wirtualnej, należy dodać regułę filtrowania, która akceptuje pocztę dla domen wirtualnych, na przykład:

table vdomains db:/etc/smtpd/vdomains.db
table vusers db:/etc/smtpd/users.db

action "local" mbox virtual <vusers>

match for domain <vdomains> action "local"
match for domain "example.org" action "local"

PLIKI

/etc/smtpd/aliases

Lista aliasów pocztowych użytkowników.

/etc/smtpd/secrets

Lista poświadczeń zdalnych stacji.

STATUS ZAKOŃCZENIA

The makemap utility exits 0 on success, and >0 if an error occurs.

ZOBACZ TAKŻE

aliases(5), smtpd.conf(5), table(5), newaliases(8), smtpd(8)

HISTORIA

Polecenie makemap pojawiło się pierwotnie w OpenBSD 4.6, jako zamiennik równoważnego polecenia dostarczanego z programem sendmail.

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Robert Luberda <robert@debian.org> 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 GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

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