mhbuildmh - Online w chmurze

PROGRAM:

IMIĘ

mhbuild - przetłumacz wersję roboczą kompozycji MIME

STRESZCZENIE

mhbuild filet [-automatyczny | -nieauto] [-lista | -nolista] [-realize | -norealistyczny rozmiar] [-nagłówki |
-bez nagłówków] [-dyrektywy | -brak dyrektyw] [- tryb rfc934 | -norfc934tryb] [-zadowolony |
-brak treści] [-gadatliwy | -przegadany] [-usposobienie | -nodyspozycja] [-czek |
-bez kontroli] [-kodowanie nagłówków algorytm kodowania | -automatyczne kodowanie nagłówków] [-maxunencoded
długość linii] [-dyst] [-wersja] [-Pomoc]

OPIS

Połączenia mhbuild polecenie przetłumaczy wersję roboczą kompozycji MIME na prawidłową wiadomość MIME.

mhbuild tworzy wiadomości multimedialne zgodnie z RFC 2045 do RFC 2049. Obejmuje to
kodowanie nagłówków wiadomości zgodnie z RFC 2047 i kodowanie MIME
parametry określone w RFC 2231.

Jeśli określisz nazwę pliku kompozycji jako „-”, wówczas mhbuild zaakceptuje
projekt składu na standardowym wejściu. Jeśli tłumaczenie tego wejścia zakończy się pomyślnie,
mhbuild wyśle ​​nowy komunikat MIME na standardowe wyjście. Ten argument musi być
ostatni argument w linii poleceń.

W przeciwnym razie, jeśli argument pliku do mhbuild jest nazwą prawidłowego pliku kompozycji, a
tłumaczenie się powiodło, mhbuild zastąpi oryginalny plik nowym MIME
wiadomość. Zmieni nazwę oryginalnego pliku, zaczynając od znaku „,” i kończąc na
ciąg „.orig”, np. jeśli edytujesz plik „draft”, jego nazwa zostanie zmieniona
„,draft.orig”. Dzięki temu można łatwo odzyskać plik mhbuild plik wejściowy.

Notowania dotychczasowy Spis treści
Połączenia -lista przełącznik mówi mhbuild aby wyświetlić spis treści skojarzony z MIME
tworzona wiadomość.

Połączenia -nagłówki przełącznik wskazuje, że baner jednowierszowy powinien być wyświetlany nad
wymienianie kolejno. ten -realize przełącznik mówi mhbuild do oceny „natywnego” (dekodowanego) formatu
każdą treść przed wystawieniem na aukcję. Zapewnia to dokładne zliczenie kosztem małego
opóźnienie. Jeśli -gadatliwy przełącznik jest obecny, wówczas na liście zostaną wyświetlone wszelkie „dodatkowe”
informacje zawarte w wiadomości, takie jak komentarze w nagłówku „Content-Type”.

Jeśli -usposobienie przełącznik jest obecny, a następnie na liście pojawią się wszelkie istotne informacje
z nagłówka „Content-Disposition”.

Uproszczony Załącznik Interfejs
Dla użytkowników, którzy chcą po prostu dołączyć pliki do treści tekstowych, mhbuild przeskanuje
plik kompozycji dla nagłówków „Załącz”. Nagłówek „Attach” zawiera nazwę pliku, która będzie
zostać dołączone do wiadomości przy użyciu normalnych reguł enkapsulacji MIME. Dozwolona jest jedna nazwa pliku
na nagłówek „Attach”, ale w pliku kompozycji dozwolonych jest wiele nagłówków „Attach”.

Pliki te zostaną dodane po wszelkiej innej zawartości MIME, łącznie z określoną treścią
by mhbuild dyrektyw (patrz poniżej). Widzieć wysłać(1) po więcej szczegółów.

Tłumacz dotychczasowy Kompozycja filet
mhbuild jest zasadniczo filtrem pomagającym w tworzeniu wiadomości MIME. mhbuild będzie
przekonwertować mhbuild „plik kompozycji” na prawidłową wiadomość MIME. A mhbuild "kompozycja
plik” to po prostu plik zawierający zwykły tekst przeplatany różnymi mhbuild
dyrektywy. Kiedy ten plik jest przetwarzany przez mhbuildbędą różne dyrektywy
rozszerzony do odpowiedniej treści i zostanie zakodowany zgodnie ze standardami MIME.
Powstałą wiadomość MIME można następnie przesłać pocztą elektroniczną.

Formalna składnia a mhbuild plik kompozycji jest zdefiniowany na końcu tego dokumentu,
ale idee stojące za tym formatem nie są skomplikowane. Zasadniczo ciało zawiera jeden lub
więcej treści. Treść składa się z dyrektywy oznaczonej jako „#”.
pierwszy znak linii; lub zwykły tekst (jeden lub więcej wierszy tekstu). Kontynuacja
znaku „\” można użyć do wprowadzenia pojedynczej dyrektywy w więcej niż jednej linii, np.

#image/png \
/home/foobar/junk/picture.png

Istnieje pięć rodzajów dyrektyw: dyrektywy „typu”, które określają typ i podtyp
Treść; Dyrektywy „typu zewnętrznego”, które określają również typ i podtyp pliku
treść; dyrektywa „wiadomość” (#forw), która służy do przekazywania jednej lub większej liczby wiadomości;
dyrektywa „begin” (#begin), która służy do tworzenia treści wieloczęściowej; i
Dyrektywy „on/off/pop” (#on, #off, #pop), które kontrolują, czy działają inne dyrektywy
w ogóle zaszczycony.

Połączenia -dyrektywy przełącznik pozwala kontrolować, czy mhbuild będzie honorował którykolwiek z
„#” – dyrektywy. Można na to również wpłynąć dyrektywami #on lub #off oraz #pop,
który przywraca stan przetwarzania do stanu poprzedzającego ostatnie #on lub #off.
(Oczywiście dyrektywy #on, #off i #pop są zawsze honorowane.) Umożliwia to włączenie
zwykłego tekstu, który wygląda jak dyrektywy mhbuild, bez powodowania błędów:

#wyłączony
#włączać
printf("Witaj, świecie!);
#Muzyka pop

Obecnie głębokość stosu dla dyrektyw #on/off/pop wynosi 32.

Dyrektywa „type” służy do bezpośredniego określenia typu i podtypu treści. Ty
może w ten sposób określać tylko typy dyskretne (nie można określić typów multipart lub
wiadomość z tą dyrektywą). Opcjonalnie możesz określić nazwę pliku zawierającego
zawartość w formacie „natywnym” (zdekodowanym). Jeśli nazwa pliku zaczyna się od „|”
znak, wówczas reprezentuje polecenie do wykonania, którego dane wyjściowe są odpowiednio przechwytywane.
Na przykład,

#audio/basic |raw2audio -F < /usr/lib/sound/giggle.au

Jeśli nazwa pliku nie zostanie podana, mhbuild będzie szukać informacji w profilu użytkownika, aby
określić, jak powinny być skomponowane różne treści. Osiąga się to poprzez
sprawdzanie ciągu kompozycji i wykonywanie go pod / Bin / sh, ze standardowym wyjściem
ustaw na treść. Jeśli -gadatliwy przełącznik jest podany, mhbuild powtórzy wszelkie polecenia
służą do tworzenia treści w ten sposób.

Ciąg znaków kompozycji może zawierać następujące ucieczki:

%a Wstaw parametry z dyrektywy
%f Wstaw nazwę pliku zawierającą zawartość
%F %f, a standardowe wyjście nie zostało przekierowane
%s Wstaw podtyp treści
%% Wstaw znak %

Po pierwsze, mhbuild poszuka wpisu formularza:

mhbuild-komponowanie- /

aby określić polecenie, którego należy użyć do utworzenia treści. Jeśli to nie zostanie znalezione, mhbuild będzie
poszukaj wpisu formularza:

mhbuild-komponowanie-

aby określić polecenie kompozycji. Jeśli to nie zostanie znalezione, mhbuild będzie narzekać.

Przykładowy wpis może brzmieć:

mhbuild-compose-audio/basic: nagrywanie | raw2audio -F

Ponieważ tego typu polecenia będą się różnić w zależności od używanego środowiska wyświetlania
login, prawdopodobnie w pliku powinny zostać umieszczone ciągi znaków dotyczące różnej zawartości
określone przez $MHBUILD zmienną środowiskową, zamiast bezpośrednio w profilu użytkownika.

Dyrektywy „typu zewnętrznego” służą raczej do zapewnienia odniesienia MIME do treści
niż załączenie samej zawartości (na przykład poprzez określenie witryny FTP). Stąd,
zamiast podawać nazwę pliku, jak w przypadku dyrektyw typu, są to parametry zewnętrzne
dostarczone. Wyglądają one jak zwykłe parametry, dlatego należy je odpowiednio oddzielić. Dla
przykład,

#@application/octet-stream; \
typ=tar; \
konwersje=kompresja \
[to jest rozkład nmh] \
{załącznik; nazwapliku="nmh.tar.gz"} \
nazwa="nmh.tar.gz"; \
katalog="/pub/nmh"; \
site="ftp.math.gatech.edu"; \
typ dostępu=anon-ftp; \
tryb="obraz"

Musisz podać ciąg opisu, aby oddzielić parametry treści od parametrów zewnętrznych.
parametry (chociaż ten ciąg może być pusty). Ten ciąg opisu jest określony przez
umieszczając go w „[]”. Ciąg dyspozycji, który ma się pojawić w „Content-Disposition”
nagłówku, może pojawić się w opcjonalnym „{}”.

Parametry te mają postać:

typ dostępu = zwykle anon-ftp, serwer poczty elektronicznejlub url
nazwa=nazwa pliku
pozwolenie = tylko do odczytu lub do odczytu i zapisu
witryna = nazwa hosta
katalog= nazwa katalogu (opcjonalnie)
tryb = zwykle Ascii or obraz (opcjonalne)
rozmiar = liczba oktetów
serwer=skrzynka pocztowa
Temat = temat do wysłania
body= polecenie wysłania w celu pobrania
url=adres URL treści

Minimalna dyrektywa „typu zewnętrznego” dla url Typ dostępu wyglądałoby następująco:

#@application/octet-stream [] typ dostępu=url; \
adres URL =http://download.savannah.gnu.org/releases/nmh/nmh-1.5.tar.gz"

Wszelkie długie adresy URL będą zawijane zgodnie z regułami RFC 2231.

Dyrektywa „wiadomość” (#forw) służy do określenia wiadomości lub grupy wiadomości, do której należy
włączać. Opcjonalnie możesz określić nazwę folderu i jakie wiadomości mają się w nim znajdować
przekazane. Jeśli folder nie zostanie podany, domyślnie będzie to folder bieżący. Podobnie, jeśli A
komunikat nie jest podany, domyślnie jest to bieżący komunikat. Zatem dyrektywa dotycząca komunikatów to
Podobny do naprzód polecenie, z tą różnicą, że to pierwsze używa reguł MIME do enkapsulacji
zamiast tych określonych w RFC 934. Na przykład

#forw +skrzynka odbiorcza 42 43 99

Jeśli dołączysz pojedynczą wiadomość, zostanie ona dołączona bezpośrednio jako treść typu
„wiadomość/rfc822”. Jeśli podasz więcej niż jedną wiadomość, to mhbuild dodam treść
typu „multipart/streszczenie” i dołączaj każdą wiadomość jako podczęść tej treści.

Jeśli używasz tej dyrektywy do dołączenia więcej niż jednej wiadomości, możesz użyć metody
- tryb rfc934 przełącznik. Ten przełącznik to wskaże mhbuild powinien spróbować wykorzystać
Reguły enkapsulacji MIME w taki sposób, że tworzony jest „wieloczęściowy/skrót”.
(przeważnie) kompatybilny z enkapsulacją określoną w RFC 934. Jeśli podano, to RFC 934
zgodne programy użytkownika powinny być w stanie przesłać wiadomość po odebraniu - pod warunkiem, że
enkapsulowane wiadomości same w sobie nie zawierają enkapsulowanych wiadomości. The
Wadą tego podejścia jest to, że enkapsulacje są generowane poprzez umieszczenie dodatkowego
znak nowej linii na końcu treści każdej wiadomości.

Dyrektywa „begin” służy do tworzenia treści wieloczęściowej. Kiedy używasz „początku”
dyrektywy, należy określić co najmniej jedną treść pomiędzy parami początkowymi i końcowymi.

#zaczynać
Będzie to wieloczęściowy film składający się tylko z jednej części.
#kończyć się

Jeśli w wersji roboczej składu używasz wielu dyrektyw, mhbuild automatycznie
hermetyzuj je w treści wieloczęściowej. Dlatego dyrektywa „begin” jest tylko dyrektywą
konieczne, jeśli chcesz użyć zagnieżdżonych części wieloczęściowych lub utworzyć wiadomość wieloczęściową zawierającą
tylko jedna część.

W przypadku wszystkich tych dyrektyw użytkownik może załączyć krótki opis treści
pomiędzy znakiem „[” a znakiem „]”. Opis ten zostanie skopiowany do pliku
Nagłówek „Content-Description” podczas przetwarzania dyrektywy.

#forw [ważny mail od Boba] +bob 1 2 3 4 5

Podobnie ciąg dyspozycji może opcjonalnie być podany pomiędzy znakami „{” i „}”;
zostanie skopiowany do nagłówka „Content-Disposition” podczas przetwarzania dyrektywy.
Jeśli podano ciąg dyspozycji, który nie zawiera parametru nazwy pliku, oraz a
nazwa pliku jest podana w dyrektywie, zostanie ona dodana do „Content-Disposition”
nagłówek. Na przykład następująca dyrektywa:

#Zwykły tekst; charset=iso-8859-1 <>{załącznik} /tmp/summary.txt

tworzy następujące nagłówki części wiadomości:

Typ zawartości: tekst/zwykły; zestaw znaków="iso-8859-1"
Dyspozycja treści: załącznik; nazwa pliku="podsumowanie.txt"

Domyślnie mhbuild wygeneruje unikalny „Content-ID:” dla każdej dyrektywy, odpowiedni
do każdej części wiadomości; jednakże użytkownik może to zmienić, definiując identyfikator za pomocą „<”
i znaki „>”. The -brak treści przełącznik blokuje tworzenie wszystkich „Content-ID:”
nagłówki, nawet na najwyższym poziomie wiadomości.

Normalnie mhbuild wybierze odpowiednie kodowanie przesyłania treści w oparciu o treść
oraz typ zawartości MIME. Można to jednak zastąpić w pliku mhbuild dyrektywa wg
określając „*” i kodowanie. Dopuszczalne wartości kodowania to „8bit”, „qpρq (for
cytowany-drukowalny) i „b64” (dla kodowania base64). Należy zauważyć, że niepożądane
wyniki mogą wystąpić, jeśli dla zawartości binarnej zostanie wybrana opcja 8-bitowa lub do druku z cytatami, ze względu na
tłumaczenie między zakończeniami linii uniksowych a zakończeniami linii używanymi w transporcie pocztowym
pomimo napiętego harmonogramu

Oprócz różnych dyrektyw może występować tekst jawny. Zbierany jest tekst jawny,
do czasu znalezienia dyrektywy lub wyczerpania projektu i wtedy powstaje tekst
treść. Jeśli tekst jawny musi zawierać „#” na początku linii, po prostu podwoj
to, np.

##po wysłaniu ta linia będzie zaczynać się tylko od jednego #

Jeśli chcesz zakończyć tekst jawny przed dyrektywą, np. aby mieć dwa teksty jawne
zawartość obok, po prostu wstaw linię zawierającą pojedynczy znak „#”, np.

to jest pierwsza treść
#
i to jest drugie

Wreszcie, jeśli tekst jawny zaczyna się od wiersza formularza:

Opis zawartości: tekst

wówczas zostanie ono użyte do opisania zawartości w postaci zwykłego tekstu. MUSISZ podążać za tą linią
pustą linię przed rozpoczęciem tekstu.

Domyślnie zwykły tekst jest przechwytywany jako tekst/zwykła treść. Możesz to zastąpić
rozpoczynając tekst jawny od „#<”, po którym następuje specyfikacja typu zawartości. Na przykład,
EC

#
ta treść zostanie oznaczona jako tekstowa/wzbogacona
#
a ta treść zostanie oznaczona jako tekst/zwykły
#
#
i ta zawartość zostanie oznaczona jako aplikacja/x-patch

Pamiętaj, że jeśli używasz formularza w postaci zwykłego tekstu „#<”, wówczas opis zawartości musi znajdować się na
ta sama linia, która określa typ zawartości tekstu jawnego.

Tworząc treść tekstową, możesz wskazać odpowiedni zestaw znaków, dodając
parametr „charset” do dyrektywy.

#

Jeśli treść tekstowa zawiera dowolne znaki 8-bitowe (znaki z ustawionym najwyższym bitem) i
wówczas zestaw znaków nie jest określony jak powyżej mhbuild przyjmie, że zestaw znaków to
typ podany w normie lokalny(1) zmienne środowiskowe. Jeśli te środowisko
zmienne nie są ustawione, wówczas zestaw znaków zostanie oznaczony jako „x-nieznany”.

Jeśli treść tekstowa zawiera tylko znaki 7-bitowe, a zestaw znaków nie jest określony jako
powyżej, zestaw znaków zostanie oznaczony jako „us-ascii”.

Domyślnie treść tekstowa z ustawionym wyższym bitem jest kodowana 8-bitowo
Kodowanie przesyłania treści. Jeśli tekst zawiera linie dłuższe niż wartość -maxunencoded
(domyślnie 78), wówczas tekst jest kodowany przy użyciu kodowania umożliwiającego drukowanie w cudzysłowie.

Połączenia -kodowanie nagłówków przełącznik wskaże, jakiego algorytmu użyć podczas kodowania dowolnej wiadomości
nagłówki zawierające znaki 8-bitowe. Prawidłowe argumenty to base64 dla opartego-64
kodowanie i zacytowany dla kodowania umożliwiającego wydrukowanie cytatu. The -automatyczne kodowanie nagłówków przełącznik będzie
pouczać mhbuild aby automatycznie wybrać algorytm, który skutkuje krótszym kodowaniem
ciąg.

Podsumowując, oto przykład bardziej skomplikowanej wersji roboczej wiadomości. The
następująca wersja robocza rozwinie się do wiadomości wieloczęściowej/mieszanej składającej się z pięciu części:

Do: [email chroniony]
cc:
Temat: Spójrz i posłuchaj mnie!
--------
Pierwsza część będzie tekstowa/zwykła
#
Druga część będzie tekstowa/wzbogacona
#
Ta trzecia część będzie tekstowa/zwykła
#audio/basic [głupi chichot] \
|raw2audio -F < /usr/lib/sounds/giggle.au
#image/gif [zdjęcie foobara] \
/home/foobar/lib/picture.gif

Integrość Kontrola
If mhbuild otrzymuje -czek przełącznik, wówczas powiąże on również kontrolę integralności z
zawartość każdego „liścia”. Spowoduje to dodanie pola nagłówka Content-MD5 do treści wraz z
suma md5 niekodowanej zawartości, zgodnie z RFC 1864. Może ona zostać wykorzystana przez odbiorcę
wiadomość, aby sprawdzić, czy treść wiadomości nie została zmieniona podczas transportu.

przelew Kodowanie
Po mhbuild konstruuje nową wiadomość MIME poprzez analizę dyrektyw, w tym plików,
itp. skanuje zawartość wiadomości, aby określić, jakiego kodowania transferu użyć.
Sprawdzi dane 8-bitowe, długie linie, spacje na końcach linii i konflikty
granice wieloczęściowe. Następnie wybierze odpowiednie dla każdego kodowanie transferu
Typ zawartości.

Jeśli sprawdzanie integralności jest skojarzone z każdą zawartością za pomocą -czek przełącznik,
następnie mhbuild zakoduje każdą treść za pomocą kodowania transferu, nawet samą treść
zawiera tylko dane 7-bitowe. Ma to na celu zwiększenie prawdopodobieństwa, że ​​treść nie jest
zmienione w transporcie.

Przywoływanie mhbuild
Zazwyczaj mhbuild jest wywoływany przez co teraz program. To polecenie będzie oczekiwać ciała
wersji roboczej w formacie mhbuild plik kompozycji. Gdy już to skomponowałeś
plik wejściowy za pomocą polecenia takiego jak zarys, zastępstwolub naprzód, wzywasz mhbuild w programie „Co
teraz” za pomocą polecenia

Co teraz? mim

przed wysłaniem wersji roboczej. To spowoduje co teraz wykonać mhbuild przetłumaczyć
plik kompozycji do formatu MIME.

Zwykle wywołanie jest błędem mhbuild w pliku, który jest już w formacie MIME. The -automatyczny
przełącznik spowoduje mhbuild aby zakończyć bez błędu, jeśli plik wejściowy ma już prawidłowy MIME
nagłówki. Sposób użycia -automatyczny umożliwia również -brak dyrektyw przełącznik.

Na koniec rozważ dodanie tej linii do swojego profilu:

lproc: pokaż

W ten sposób, jeśli się zdecydujesz podstęp po wywołaniu mim, Komenda

Co teraz? lista

będzie działać zgodnie z oczekiwaniami.

Połączenia -dyst przełącznik jest przeznaczony do użytku przez dist. Spowoduje to, że mhbuild nie będzie generowany
dowolne nagłówki MIME w pliku kompozycji (takie jak „wersja MIME” lub „typ zawartości”), ale
nadal będzie kodować nagłówki wiadomości zgodnie z RFC 2047.

Użytkownik Środowisko
Ponieważ środowisko, w którym mhbuild działanie może się różnić w zależności od użytkownika, mhbuild będzie wyglądać
dla zmiennej środowiskowej $MHBUILD. Jeśli jest obecny, określa nazwę pliku
dodatkowy profil użytkownika, z którym należy się zapoznać. Dlatego też, gdy użytkownik loguje się na konkretnym
machine, ta zmienna środowiskowa powinna być ustawiona tak, aby odnosiła się do pliku zawierającego definicje
przydatne dla tej maszyny.

Wreszcie, mhbuild spróbuje się skonsultować

/etc/nmh/mhn.defaults

jeśli istnieje.

Zobacz „Wyszukiwanie profilu” w profil mh(5) dla kolejności wyszukiwania profili i sposobu duplikacji
wpisy są traktowane.

Składnia of Kompozycja Akta
Poniżej znajduje się formalna składnia a mhbuild „plik kompozycji”.

treść ::= 1*(treść | EOL)

treść ::= dyrektywa | tekst jawny

dyrektywa ::= Podtyp „#” typu „/”.
0*(";" atrybut "=" wartość)
[ "(" komentarz ")" ]
[ "<" identyfikator ">" ]
[ "[" opis "]" ]
[ "{" dyspozycja "}" ]
[ "*8bit" | "*qp" | „*b64”]
[ Nazwa pliku ]
EOL

| Podtyp „#@” typu „/”.
0*(";" atrybut "=" wartość)
[ "(" komentarz ")" ]
[ "<" identyfikator ">" ]
[ "[" opis "]" ]
[ "{" dyspozycja "}" ]
[ "*8bit" | "*qp" | „*b64”]
parametry zewnętrzne
EOL

| „#forw”
[ "<" identyfikator ">" ]
[ "[" opis "]" ]
[ "{" dyspozycja "}" ]
[folder "+" ] [ 0*msg ]
EOL

| "#zaczynać"
[ "<" identyfikator ">" ]
[ "[" opis "]" ]
[ "{" dyspozycja "}" ]
[ „alternatywa”
| "równoległy"
| coś innego ]
EOL
1*korpus
„#koniec” EOL

tekst jawny ::= [ "Opis treści:"
opis EOL EOL ]
1 * linia
[„#” EOL ]

| Podtyp „#<” typu „/”.
0*(";" atrybut "=" wartość)
[ "(" komentarz ")" ]
[ "[" opis "]" ]
[ "{" dyspozycja "}" ]
[ "*8bit" | "*qp" | „*b64”]
EOL
1 * linia
[„#” EOL ]

linia ::= "##" tekst EOL
-- interpretowane jako tekst „#” EOL
| napisz wiadomość EOL

Użyj mhbuildmh online, korzystając z usług onworks.net