.\" -*- coding: UTF-8 -*- .\" $OpenBSD: makemap.8,v 1.31 2021/02/13 07:37:13 jmc Exp $ .\" .\" Copyright (c) 2009 Jacek Masiulaniec .\" Copyright (c) 2008-2009 Gilles Chehade .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .Dd $Mdocdate: February 13 2021 $ .Dt MAKEMAP 8 .Os .Sh NAZWA .Nm makemap .Nd tworzy bazy map dla smtpd .Sh SKŁADNIA .Nm makemap .Op Fl U .Op Fl d Ar typ-b-d .Op Fl o Ar plik-b-d .Op Fl t Ar typ .Ar plik .Sh 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 .Nm makemap tworzy mapy baz danych za pomocą powiązań wyszukiwań z kluczem określonych w .Xr smtpd.conf 5 . .Pp .Nm makemap odczytuje wejście z .Ar pliku i zapisuje dane do pliku, którego nazwa powstaje przez dodanie do .Ar pliku przyrostka \[Bq].db\[rq]. Bieżący wiersz może być kontynuowany w kolejnych wiersza za pomocą ukośnika \[Bq]\e\[rq]. Komentarze można umieszczać gdziekolwiek w pliku, za pomocą znaku kratki \[Bq]#\[rq] 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, .Nm 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. .Pp Dostępne są następujące opcje: .Bl -tag -width Ds .It Fl d Ar typ-b-d Określa format bazy danych. Dostępne formaty to: .Ar hash oraz .Ar btree . Domyślną wartością jest .Ar hash . .It Fl o Ar plik-b-d Zapisuje utworzoną bazę danych do .Ar pliku-b-d . .It Fl t Ar 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 \[Bq]klucz do wartości\[rq]. Jeśli jednak wiązana wartość ma specjalne znaczenie, jak ma to miejsce w pliku domen wirtualnych, konieczne jest podanie odpowiedniego .Ar typu . Dostępne typy wyjściowe to: .Bl -tag -width aliases .It Cm 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. .It Cm set Brak jest przypisywanych wartości \[en] mapy tego typu pozwalają na wyszukiwanie jedynie samych kluczy. Format może służyć do budowania map domen podstawowych. .El .It Fl U Zamiast generować mapę bazę danych z wejścia tekstowego, zrzuca zawartość mapy bazy danych jako tekst, gdzie klucz i wartość są rozdzielone tabulatorem. .El .Sh DOMENY POSTAWOWE Domeny podstawowe można przechowywać w tablicach. Aby utworzyć tablicę podstawowych domen, należy dodać każdą domenę podstawową jako pojedynczy wiersz. .Pp 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: .Bd -literal -offset indent table domains db:/etc/smtpd/domains.db action "local" mbox dla domeny dopasowuje akcję "local" .Ed .Sh 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. .Pp 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 .Xr aliases 5 , co pozwala korzystania z \[Bq]user@domain.tld\[rq] aby akceptować użytkowników tylko w określonej domenie, \[Bq]user\[rq] aby akceptować użytkowników dla dowolnej z domen wirtualnych, \[Bq]@domain.tld\[rq] aby przechwycić konkretną domenę i \[Bq]@\[rq] aby przechwycić wszystkich dla wszystkich domen. .Xr smtpd 8 wykona przeszukiwania w tej, podanej kolejności. .Pp Aby utworzyć pojedynczy adres wirtualny, należy dodać \[Bq]user@example.com user\[rq] do mapy użytkowników. Aby obsłużyć całą pocztę skierowaną do dowolnego użytkownika w example.com, należy dodać \[Bq]@example.com user\[rq] do mapy wirtualnej. .Pp Oprócz dodawania wpisów dla mapy wirtualnej, należy dodać regułę filtrowania, która akceptuje pocztę dla domen wirtualnych, na przykład: .Bd -literal -offset indent table vdomains db:/etc/smtpd/vdomains.db table vusers db:/etc/smtpd/users.db action "local" mbox virtual match for domain action "local" match for domain "example.org" action "local" .Ed .Sh PLIKI .Bl -tag -width /etc/smtpd/aliasesXXX -compact .It Pa /etc/smtpd/aliases Lista aliasów pocztowych użytkowników. .It Pa /etc/smtpd/secrets Lista poświadczeń zdalnych stacji. .El .Sh STATUS ZAKOŃCZENIA .Ex -std makemap .Sh ZOBACZ TAKŻE .Xr aliases 5 , .Xr smtpd.conf 5 , .Xr table 5 , .Xr newaliases 8 , .Xr smtpd 8 .Sh HISTORIA Polecenie .Nm makemap pojawiło się pierwotnie w .Ox 4.6 , jako zamiennik równoważnego polecenia dostarczanego z programem sendmail. .Pp .Sh TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys , Robert Luberda 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 .