Protok

1
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)

• Protokól POP3 jest przeznaczony do wygodnej
  realizacji dynamicznego dostepu do skrzynki
  pocztowej obslugiwanej przez host serwera
  poczty, tzn. umozliwienia klienckiej stacji
  roboczej podejmowania przechowywanej tam poczty.
  W zasadzie ogranicza sie on do podejmowania
  poczty z serwera i nastepnie jej usuwania.
  Bardziej uniwersalnych i wyrafinowanych uslug
  dostarcza protokól IMAP.
• Podstawowa zasada dzialania
• Inicjacja protokolu polega na nasluchiwaniu przez
  serwer (S) uslugi POP3 na porcie 110 (TCP). Gdy
  klient (C) chce skorzystac z uslugi, wtedy
  ustanawia polaczenie TCP z serwerem. Po wyslaniu
  przez serwer pozdrowienia klient i serwer
  wymieniaja polecenia i odpowiedzi do czasu
  zamkniecia lub porzucenia polaczenia.

2
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)

• Polecenia w POP3 skladaja sie ze slów kluczowych
  , po których moga wystapic argumenty polecenia.
  Wszystkie polecenia sa konczone sekwencja ltCRLFgt.
  Slowa kluczowe i argumenty redagowane sa ze
  znaków ASCII i przedzielone pojedynczymi
  spacjami. Slowa kluczowe maja dlugosc 3 lub 4
  znaków. Dlugosc argumentów jest ograniczona do 40
  znaków.
• Odpowiedzi w POP3 rozpoczynaja sie ze wskaznika
  statusu (OK lub ERR, zawsze duze litery), po
  którym moze wystapic dodatkowa informacja.
  Wszystkie odpowiedzi sa konczone sekwencja
  ltCRLFgt. Dlugosc odpowiedzi jest ograniczona do
  512 znaków. Odpowiedzi na niektóre polecenia moga
  skladac sie z wielu linii. Wtedy koncowa linia
  zawiera
• znak konca (oktet . 046) i ltCRLFgt.

3
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Kazda sesja protokolu POP3 moze sie skladac z
trzech kolejnych faz (stanów) AUTORYZACJI
(AUTHORIZATION) po otwarciu polaczenia TCP
serwer wysyla pozdrowienie, zas klient musi sie
zidentyfikowac w stosunku do serwera. Po
pomyslnej identyfikacji serwer pozyskuje zasoby
zdeponowane w skrzynce pocztowej klienta i
nastepuje przejscie do stanu TRANSAKCJI. TRANSAKCJ
I (TRANSACTION) klient za pomoca wydawanych
kolejno polecen inicjuje okreslone dzialania
serwera. Poleceniem QUIT powoduje przejscie do
stanu UAKTUALNIANIA. UAKTUALNIANIA (UPDATE)
serwer POP3 zwalnia zasoby pozyskane podczas fazy
TRANSAKCJI i zegna sie z klientem. Polaczenie
TCP zostaje zamkniete.
4
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Dodatkowe wymagania protokolarne Serwer MUSI
udzielic odpowiedzi na nierozpoznane,
niezaimplementowane, nieprawidlowe skladniowo
polecenie klienta lub w przypadku niewlasciwej
polecenie dla biezacego stanu sesji
komunikacyjnej przez wyslanie wskaznika
negatywnego statusu. Nie ma ogólnej zasady, która
pozwolilaby klientowi stwierdzic, czy negatywna
odpowiedz serwera wynika z niezaimplementowanej
obslugi polecenia opcjonalnego, czy tez z faktu,
ze serwer nie chce obsluzyc klienta. Serwer
MOZE miec zaimplementowane mechanizmy kontroli
czasu przerwy miedzy kolejnymi poleceniami
klienta (autologout timer). Jezeli je ma, to
odpowiedni czas reakcji MUSI wynosic co najmniej
10 minut. Jezeli czas ten uplynie w stanie
TRANSAKCJI, to sesja nie osiaga stanu
UAKTUALNIENIA i SERWER musi zamknac polaczenie
TCP bez usuwania jakichkolwiek wiadomosci lub
wysylania odpowiedzi do klienta.
5
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Stan AUTORYZACJI Po otwarciu polaczenia TCP przez
klienta POP3 serwer POP3 wysyla jedynie linie
powitania, np. S OK POP3
server ready Sesja wkracza w stan AUTORYZACJI.
Identyfikacja klienta wzgledem serwera moze byc
zrealizowana przez laczne dzialanie polecen USER
i PASS albo opcjonalnego polecenia APOP. Bardziej
wyrafinowane mechanizmy uwierzytelniania
klienta, wykorzystujace np. protokól Kerberos lub
funkcje skrótu MD5 okreslono definiujac dodatkowe
polecenie AUTH w dokumencie RFC 1734. Serwer POP3
musi zapewniac obsluge co najmniej jednego z tych
mechanizmów potwierdzania tozsamosci klienta.
6
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Uwierzytelnianie USER i PASS Najpierw klient
wydaje polecenie USER, którego argumentem jest
nazwa skrzynki pocztowej o znaczeniu istotnym
wylacznie dla serwera. Jezeli serwer odpowie
-ERR, to klient ponownie próbuje sie
uwierzytelnic, lub konczy sesje poleceniem
QUIT. Jezeli serwer odpowie OK, to klient
kontynuuje uwierzytelnianie poleceniem PASS, lub
konczy sesje poleceniem QUIT. Polecenie PASS,
którego argumentem jest haslo (ciag znaków)
powoduje, ze serwer zestawia nazwe i haslo, i na
tej podstawie decyduje o udostepnieniu zasobów
skrzynki pocztowej. Przyklad 1 C USER batman S
-ERR sorry, nor mailbox for batman here C
QUIT S OK dewey POP3 server signing off
7
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Przyklad 2 C USER batman S OK batman is a
real mailbox user C PASS secret S -ERR mailbox
already locked C QUIT S OK dewey POP3 server
signing off Przyklad 3 C USER batman S OK
batman is a real mailbox user C PASS secret S
OK batmans mailbox has 3 messages (320
octets) (i przejscie w stan TRANSAKCJI)
8
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)

• Uwierzytelnianie APOP
• Argumentami polecenia APOP sa nazwa skrzynki
  pocztowej (ta sama, co wykorzystywana w poleceniu
  USER) oraz wartosc funkcji skrótu MD5 obliczona
  dla lancucha tekstowego utworzonego przez
  konkatenacje
• znacznika czasu utworzonego przez unikalna
  sekwencje zwiazana z czasem, numerem procesu,
  itp. oraz nazwe domeny (w nawiasach ltgt),
  przekazywanego podczas powitania przez serwer
  POP3
• nazwy skrzynki pocztowej.
• Przyklad
• (powitanie i przekazanie znacznika czasu)
• S OK POP3 server ready
• lt1896.697170952_at_dbc.mtview.ca.usgt
• (uwierzytelnianie)
• C APOP mrose c4c9334bac560ecc979e58001b3e22fb
• S OK maildrop has 1 message (369 octets)

9
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
UWAGA c4c9334bac560ecc979e58001b3e22fb to
wartosc funkcji skrótu MD5 dla lancucha
lt1896.697170952_at_dbc.mtview.ca.usgttanstaaf , gdzie
tanstaaf spelnia role sekretu znanego serwerowi i
klientowi mrose. Po pomyslnej autoryzacji
serwer POP3 pozyskuje zasoby zdeponowane w
skrzynce pocztowej i blokuje je w celu
uniemozliwienia jakichkolwiek modyfikacji przed
osiagnieciem stanu UAKTUALNIENIA. Jezeli z
róznych powodów serwer udzieli odpowiedzi
negatywnej, lecz nie zamknie polaczenia, to
klient moze zakonczyc sesje wydajac polecenie
QUIT lub próbowac ponownie wydac nowe polecenie
wiodace do potwierdzenia tozsamosci. Jezeli
serwer POP3 otworzy skrzynke pocztowa, to
wówczas przypisuje kazdej wiadomosci numer
kolejny i jej rozmiar w oktetach (w notacji
dziesietnej).
10
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Stan TRANSAKCJI W tym stanie sesji klient wydaje
kolejne polecenia i otrzymuje kolejne odpowiedzi
od serwera. Poleceniem QUIT przeprowadza sesje
do stanu uaktualnienia. Polecenie STAT -
polecenie bezargumentowe zwracajace co najmniej
informacje o liczbie wiadomosci (nie oznaczonych
jako usunietych) przechowywanych w skrzynce
pocztowej i ich lacznym rozmiarze w
oktetach. Przyklad C STAT S OK 3 320 (w
skrzynce sa 3 wiadomosci o lacznej dlugosci 320
oktetów)
11
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Polecenie LIST Polecenie zwracajace liste
informacji o wiadomosciach (nie oznaczonych jako
usunietych) przechowywanych w skrzynce pocztowej
i ich rozmiarze, badz przy podanym jako argument
numerze wiadomosci, informacje o rozmiarze tej
konkretnej wiadomosci. Przyklad 1 C LIST S OK
3 messages (320 octets) S 1 100 S 2 80 S 3
140 S . Przyklad 2 Przyklad 3 C LIST 3 C
LIST 4 S OK 3 140 S -ERR no such message,
only 3 messages in maildrop
12
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Polecenie RETR Polecenie, którego argumentem jest
numer (nie oznaczonej jako usunietej) wiadomosci.
Jezeli wiadomosc o takim numerze znajduje sie w
skrzynce, to zostanie odeslana klientowi (w
pakietach po 512 znaków z ltCRLFgt
wlacznie. Przyklad C RETR 2 S OK 80 octets S
lt40 first octetsgt S lt40 last octetsgt S
. Polecenie NOOP Bezargumentowe polecenie,
wykorzystywane np. do podtrzymania sesji w
stanie TRANSAKCJI. Przyklad C NOOP S OK
13
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Polecenie DELE Polecenie, którego argumentem jest
numer (nie oznaczonej jako usunietej) wiadomosci.
Jezeli wiadomosc o takim numerze znajduje sie w
skrzynce, to zostanie oznaczona przez serwer POP3
jako usunieta. Do czasu UAKTUALNIENIA wiadomosc o
tym numerze jest niedostepna dla innych polecen.
Na próby odwolania sie do niej uzyskuje sie
odpowiedz sygnalizujaca blad. Przyklad 1 C DELE
1 S OK message 1 deleted Przyklad 2 C DELE
3 S -ERR message 3 already deleted
14
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Polecenie RSET Polecenie bezargumentowe
kasujace rezultaty wydanych dotychczas polecen
DELE i przywracajace dostep do oznaczonych jako
usuniete wiadomosci. Przyklad C RSET S OK
maildrop has 3 messages (320 octets) Opcjonalne
polecenia UIDL i TOP (zalecane, ale nie
konieczne) Polecenie UIDL wydane bez argumentów
zwraca liste wiadomosci w formie zestawienia ich
numerów i unikalnych identyfikatorów wartosci
funkcji skrótu (o dlugosci do 70 znaków ASCII),
zas z argumentem bedacym numerem wiadomosci
numer tej wiadomosci wraz z tym unikalnym
identyfikatorem (podobnie jak polecenie
LIST). Polecenie TOP, którego argumentami sa
numer wiadomosci i liczba linii, powoduje
przeslanie do klienta naglówka wiadomosci,
jednego wiersza pustego i tylu pierwszych linii,
ile okreslono w drugim z argumentów.
15
STANDARDY I SYSTEMY OTWARTE POP3 (Post Office
Protocol RFC 1939)
Stan UAKTUALNIENIA Stan osiagany po wydaniu przez
klienta polecenia QUIT w stanie TRANSAKCJI.
Wiadomosci oznaczone jako usuniete sa trwale
usuwane ze skrzynki pocztowej. Przyklad 1 C
QUIT S OK dewey POP3 server signing off
(maildrop empty) Przyklad 2 CQUIT SOK dewey
POP3 server signing off (2 messages left)
16
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)

• Protokól IMAP4 umozliwia klientowi dostep do
  wiadomosci pocztowych na serwerze oraz
  manipulowanie nimi. Protokól ten obejmuje
  operacje
• tworzenia, usuwania i zmiany nazwy skrzynki
  pocztowej,
• sprawdzanie nowych wiadomosci i ich trwale
  usuwanie,
• ustawianie i zerowanie odpowiednich flag,
• interpretacje (parsing) formatów RFC822 i
  MIME,
• wyszukiwanie i selektywne pobieranie atrybutów
  wiadomosci, tekstów i ich czesci.
• IMAP4 nie sluzy do nadawania wiadomosci pozostaje
  to w gestii protokolów przekazywania poczty,
  takich jak np. SMTP.
• IMAP4 przeznaczony jest do wspólpracy z jednym
  serwerem (kwestie wspólpracy z wieloma serwerami
  IMAP4 dyskutuje sie przy okazji IMSP Internet
  Multi-Server Protocol).

17
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)

• Wiadomosci na serwerze sa dostepne przez ich
  kolejne numery lub tzw. unikalne identyfikatory.
• Protokól po zestawieniu polaczenia i przeslaniu
  przez serwer pozdrowienia polega na kolejnych
  interakcjach klienta (C) i serwera (S)
• poleceniach klienta,
• danych serwera,
• odpowiedziach serwera o rezultacie zakonczenia
  obslugi polecenia klienta.
• Wszystkie interakcje sa przesylane w formie
  linii zakonczonych sekwencja ltCRLFgt, przy czym
  ich odczyt polega na odczycie linii lub odczycie
  sekwencji oktetów o znanej dlugosci, za którymi
  nastepuje linia.
• Polecenie klienta rozpoczyna operacje. Kazde
  polecenie klienta poprzedzone jest tzw.
  znacznikiem (tag), róznym dla kazdego
  polecenia. Znacznik jest zazwyczaj krótkim
  lancuchem alfanumerycznym (np. A001, A002, itd.).

18
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)

• Istnieja dwa przypadki, gdy linia wyslana przez
  klienta nie jest kompletnym poleceniem
• argument polecenia jest literalem (tzn.
  ciagiem ujetym w cudzyslów), po którym nastepuje
  liczba oktetów ujeta w zwykle nawiasy i ltCRLFgt,
• argumenty polecenia wymagaja sprzezenia
  zwrotnego od serwera (np. w poleceniu
  AUTHENTICATE).
• W obu powyzszych przypadkach serwer, gdy jest
  gotowy, odsyla tzw. odpowiedz na zadanie
  kontynuacji polecenia poprzedzona prefiksem ,
• Linie danych, przesylane normalnie przez serwer w
  odpowiedzi na polecenie klienta, poprzedzone sa
  prefiksem ,
• Linia informujaca o zakonczeniu obslugi polecenia
  przez serwer zaczyna sie od tego samego znacznika
  (tag), od którego zaczynala sie linia
  polecenia, odpowiedzi wlasciwej (OK, NO lub BAD),
  oraz ewentualnych dodatkowych informacji.

19
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)

• Klient moze przed odebraniem odpowiedzi o
  zakonczeniu obslugi poprzedniego polecenia wydac
  kolejne polecenie o innym znaczniku i odebrac
  odpowiedz o zakonczeniu obslugi tego nowego
  polecenia przed odpowiedzia o zakonczeniu obslugi
  poprzedniego (pod warunkiem, ze nie klóci sie to
  z logika obslugi).
• Przyklad
• S OK IMAP4 Service Ready
• C a001 login marc secret
• S a001 OK LOGIN completed
• C a002 select inbox
• S 18 EXISTS
• S FLAGS (\Answered \Flagged\ Deleted\ Seen)
• S 2 RECENT
• S a002 OK READ-WRITE SELECT completed
• Serwer IMPA4 moze znajdowac sie podczas sesji
  komunikacyjnej z klientem w jednym z czterech
  stanów
• stan braku uwierzytelnienia (non-authenticated),
  
• stan uwierzytelnienia (authenticated),
• stan wybrania (selected),
• stan wylogowania (logout).

20
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
Diagram przejsc miedzy stanami Inicjacja
polaczenia i pozdrowienie od serwera
Wylogowanie i zamkniecie
polaczenia (1) polaczenie bez uwierzytelniania
wstepnego (potwierdzenie OK.) (2) polaczenie ze
wstepnym uwierzytelnieniem (potwierdzenie
PREAUTH) (3) polaczenie odrzucone (pozegnanie
BYE) (4) pomyslne wykonanie polecenia LOGIN lub
AUTHENTICATE (5) pomyslne wykonanie polecenia
SELECT lub EXAMINE (6) polecenie CLOSE lub
niepomyslny wynik polecenia SELECT lub
EXAMINE (7) polecenie LOGOUT, wylaczenie serwera
lub zamkniecie polaczenia
1
Non-authenticated
2
4
3
Autenticated
6
3
7
Selected
7
7
21
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
Polecenia wydawane w dowolnym stanie CAPABILITY P
ytanie o liste dostepnych na serwerze uslug,
niezalezna od stanu polaczenia i samego
uzytkownika serwer MUSI odeslac informacje o
dostepnosci IMAP4 jako pierwsza pozycje listy
pozostale pozycje listy moga wskazywac na
dostepne uslugi zgodne z rozszerzeniami protokolu
IMAP4, nowelizacjami lub uzupelnieniami
specyfikacji tego protokolu (przez wskazanie
odpowiednich rozszerzen, nowelizacji lub
uzupelnien). Przyklad C abcd CAPABILITY S
CAPABILITY IMAP4 S abcd OK CAPABILITY completed
22
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
NOOP Polecenie puste, ale np. zerujace licznik
czasu odmierzajacy time-out podczas
bezczynnosci klienta moze byc takze
wykorzystywane do odswiezania informacji o
biezacym stanie skrzynki pocztowej. Przyklad C
a002 NOOP S a002 OK NOOP completed ... C a047
NOOP S 22 EXPUNGE S 23 EXISTS S 3
RECENT S 14 FETCH (FLAGS (\Seen \Deleted)) S
a047 OK NOOP completed
23
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
LOGOUT Polecenie sygnalizujace serwerowi zamiar
zakonczenia sesji przez klienta serwer musi w
odpowiedzi pozegnac klienta (wierszem danych
bez znacznika zawierajacym slowo kluczowe BYE), a
nastepnie potwierdzic fakt zamkniecia polaczenia
odpowiedzia z odpowiednim znacznikiem. Przyklad C
a023 LOGOUT S BYE IMAP4 Server logging
out S a023 OK LOGOUT completed
24
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
Polecenia wydawane w stanie NON-AUTHENTICATED LOG
IN Polecenie uwierzytelniajace klienta, którego
argumentami sa nazwa klienta i jego haslo w
formie jawnej po pomyslnym uwierzytelnieniu
nastepuje przejscie do stanu AUTHENTICATED. Przykl
ad C a031 LOGIN PEJAS ABRAKADABRA S a031 OK
LOGIN completed
25
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
AUTHENTICATE Polecenie wskazujace serwerowi
wybrany (sugerowany) przez klienta mechanizm
uwierzytelniania jezeli serwer zapewnia obsluge
sugerowanego mechanizmu, to jest to jednoczesnie
inicjacja wskazanego protokolu uwierzytelniajacego
w trakcie realizacji tego protokolu mozliwe
jest takze uzgodnienie kluczy kryptograficznych
zapewniajacych (wraz z odpowiednimi algorytmami)
integralnosc i poufnosc wszystkich danych
wymienianych podczas sesji komunikacyjnej (po
zakonczeniu uwierzytelniania i przejsciu do stanu
AUTHENTICATED kolejne polecenia klienta i
odpowiedzi serwera przesylane sa w formie
pakietów bajtów poprzedzonych 4-bajtowa
informacja o dlugosci kryptogramu i
kryptograficznej sumy kontrolnej). Przyklad S
OK KerberosV4 IMAP4 Server C a033 AUTHENTICATE
KERBEROS_V4 S AmFYig (wyzwanie serwera) C
BAcAQU5EUkVXLkNNVS5FRFUA. S or//EoAADZI C
DiAF5A4gAo0IalUBkAAmw S a033 OK Kerberos V4
authentication succesful
26
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
Polecenia wydawane w stanie AUTHENTICATED SELECT
Polecenie wyboru skrzynki pocztowej w
odpowiedzi serwer zwraca informacje dotyczace
miedzy innymi biezacych atrybutów (FLAGS)
wskazanej w poleceniu skrzynki, liczby
wiadomosci w skrzynce, liczby wiadomosci, które
pojawily sie w skrzynce od poprzedniej sesji
(jezeli brak mechanizmu rozrózniania takich
wiadomosci, to wszystkie wiadomosci maja status
swiezych), trybu dostepu do wiadomosci, itd. W
trakcie jednej sesji komunikacyjnej mozna wybrac
tylko jedna skrzynke pocztowa. Przyklad C
a142 SELECT INBOX S 172 EXISTS S 1
RECENT S OK UNSEEN 12 Message 12 is first
unseen S OK UIDVALIDITY 3857529045 UIDs
valid S FLAGS (\Answered \Flagged \Deleted
\Seen \Draft) S OK PERMANENTFLAGS (\Deleted
\Seen \) Limited S a142 OK READ-WRITE SELECT
completed
27
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
EXAMINE Polecenie wyboru skrzynki pocztowej w
trybie odczytu (bez mozliwosci manipulacji
zawartoscia skrzynki) odpowiedzi serwera
identyczne, jak w przypadku polecenia
SELECT. Przyklad C a423 EXAMINE dziekanat S
17 EXISTS S 2 RECENT S OK UNSEEN 8
Message 8 is first unseen S OK UIDVALIDITY
3857529045 UIDs valid S FLAGS (\Answered
\Flagged \Deleted \Seen \Draft) S OK
PERMANENTFLAGS () No permanent flags S a423 OK
READ-ONLY EXAMINE completed
28
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
CREATE Polecenie utworzenia nowej skrzynki
pocztowej w zaleznosci od implementacji
istnieje mozliwosc (za pomoca separatora /)
utworzenia jednoczesnie dwóch róznych
równorzednych skrzynek, badz zainicjowania
hierarchicznej struktury skrzynek. Przyklad C
b001 CREATE baby/ S b001 OK CREATE completed C
b002 CREATE baby/sitter S b002 OK CREATE
completed DELETE Polecenie usuniecia skrzynki
pocztowej. Przyklad C b011 DELETE baby S b011
OK DELETE completed
29
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
RENAME Polecenie zmiany nazwy skrzynki
pocztowej. Przyklad C b111 RENAME baby
adult S b111 OK RENAME completed (nowa nazwa
skrzynki pocztowej - adult) SUBSCRIBE Polecenie
powoduje dodanie wskazanej skrzynki pocztowej
do listy skrzynek aktywnych obslugiwanych przez
serwer. Przyklad C mama SUBSCRIBE
news.comp.mail.mime S mama OK SUBSCRIBE
completed
30
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
UNSUBSCRIBE Polecenie powoduje usuniecie
wskazanej skrzynki pocztowej z listy skrzynek
aktywnych obslugiwanych przez serwer. Przyklad C
moma UNSUBSCRIBE news.comp.mail.mime S moma
OK UNSUBSCRIBE completed LIST Polecenie, którego
argumentami sa nazwa odniesienia i nazwa
skrzynki pocztowej (z mozliwoscia stosowania
znaków wieloznacznosci, tzw. wildcards), sluzy do
uzyskania informacji o skrzynkach pocztowych
dostepnych dla uzytkownika. Przyklad C A002
LIST /Mail/ S LIST (\Noselect) /
/Mail/foo S LIST () / /Mail/meetings S
A002 OK LIST completed
31
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
LSUB Polecenie analogiczne jak polecenie LIST,
lecz tym razem uzyskuje sie informacje o
skrzynkach pocztowych, które zostaly
zadeklarowane przez uzytkownika jako aktywne (za
pomoca polecenia SUBSCRIBE). Przyklad C A003
LSUB news. comp.mail. S LSUB () .
news.comp.mail.mime S LSUB () .
news.comp.mail.misc S A003 OK LSUB completed
32
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
APPEND Polecenie umieszczenia pewnego tekstu jako
nowej wiadomosci w skrzynce pocztowej. UWAGA nie
jest to polecenie wyslania wiadomosci (tym sie
zajmuje np. SMTP). Przyklad C A004 APPEND
saved-messages (\Seen) 310 C Date Sun, 29 Feb
2004 154000 0800 (PST) C From redhead
ltnick_at_wi.ps.plgt C Subject balanga C To
barbapapa_at_wi.ps.pl C Message-Id
ltX1673-010000_at_wi.ps.plgt C MIME-Version 1.0 C
Content-Type TEXT/PLAIN CHARSETUS-ASCII C C
What should we do with the drunken sailor ? C S
A004 OK APPEND completed
33
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
Polecenia wydawane w stanie SELECTED CHECK Sprawd
zenie biezacego stanu wybranej skrzynki. UWAGA
nie umozliwia sprawdzenia nowych wiadomosci,
które wplynely po zakonczeniu obslugi polecen
SELECT lub EXAMINE. Przyklad C X004 CHECK S
17 EXISTS S 2 RECENT S OK UNSEEN 8
Message 8 is first unseen S OK UIDVALIDITY
3857529045 UIDs valid S FLAGS (\Answered
\Flagged \Deleted \Seen \Draft) S OK
PERMANENTFLAGS () No permanent flags S X004 OK
CHECK completed
34
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
CLOSE Zamkniecie biezacej skrzynki, a ponadto w
przypadku wczesniejszego wyboru poleceniem SELECT
w trybie umozliwiajacym zapis trwale usuniecie
wszystkich wiadomosci oznaczonych jako Deleted
(bez jawnego informowania o tym uzytkownika)
powrót do stanu AUTHENTICATED. UWAGA mozliwy
jest wybór nowej skrzynki bez uprzedniego
polecenia CLOSE, ale nie sa wtedy trwale usuwane
wiadomosci oznaczone jako Deleted. Przyklad C
Xxyz CLOSE S Xxyz OK CLOSE completed
35
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
EXPUNGE Trwale usuniecie wszystkich wiadomosci
oznaczonych jako Deleted z jawnym informowaniem o
usuwaniu kolejnych (numerowanych)
wiadomosci. Przyklad C D001 EXPUNGE S 3
EXPUNGE S 3 EXPUNGE S 5 EXPUNGE S 8
EXPUNGE S D001 OK EXPUNGE completed UWAGA w
powyzszym przykladzie usunieto wiadomosci o
numerach pierwotnych 3, 4, 7 i 11 (efekt biezacej
aktualizacji numeracji wiadomosci w skrzynce).
36
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
SEARCH Wyszukiwanie wiadomosci na podstawie
róznych opcjonalnych kryteriów wyszukiwania
(patrz RFC 1730). Przyklad C C101 SEARCH
FLAGGED SINCE 12-Feb-2004 NOT FROM PEJAS S
SEARCH 2 84 882 (znaleziono wiadomosci o numerach
2, 84 i 882) S C101 OK SEARCH completed FETCH Pob
ranie wiadomosci (jednej lub wielu wybór na
podstawie róznych opcjonalnych kryteriów patrz
RFC 1730). Przyklad C CCCC FETCH 24 (FLAGS
RFC822.HEADER.LINES (DATE FROM)) S 2 FETCH
... S 3 FETCH ... S 4 FETCH ... S CCCC OK
FETCH completed
37
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
PARTIAL Pobranie czesci wiadomosci (podobnie jak
w przypadku FETCH - wybór na podstawie róznych
opcjonalnych kryteriów patrz RFC
1730). Przyklad C CC1C PARTIAL 4 RFC822 1
1024 S 1 FETCH (RFC822 1024 S Return-path
ltjpejas_at_wi.ps.plgt S S .FLAGS (\Seen)) S
CC1C OK PARTIAL completed
38
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
STORE Aktualizacja wiadomosci lub jej atrybutów
dodatkowe zastosowanie opcji SILENT powoduje, iz
serwer nie zwraca informacji o stanie wiadomosci
po wykonaniu operacji STORE (rózne opcjonalne
kryteria patrz RFC 1730). Przyklad C A00C
STORE 24 FLAGS (\Deleted) S 2 FETCH FLAGS
(\Deleted \Seen) S 3 FETCH FLAGS (\Deleted) S
4 FETCH FLAGS (\Deleted \Flagged \Seen) S A00C
OK STORE completed COPY Kopiowanie wskazanych
wiadomosci do wskazanej skrzynki
pocztowej. Przyklad C A012 COPY 24
dziekanat S A012 OK COPY completed
39
STANDARDY I SYSTEMY OTWARTE IMAP4 (Internet
Message Access Protocol RFC 1730)
UID Umozliwia wybór konkretnych wiadomosci do
operacji FETCH, COPY, STORE lub SEARCH wszystkie
wiadomosci maja swoje unikalne identyfikatory
Unique IDentifiers (w przeciwienstwie do numerów
kolejnych nie ulegaja one nigdy
zmianie). Przyklad C A033 UID FETCH
48273134828442 FLAGS S 23 FETCH (FLAGS
(\Seen) UID 4827313 S 24 FETCH (FLAGS (\Seen)
UID 4827943 S 25 FETCH (FLAGS (\Seen) UID
4828442 S A033 OK UID FETCH completed Xltpolecenie
wlasne uzytkownikagt Mozliwosc tworzenia wlasnych
specyficznych polecen uzytkownika (co mu w duszy
zagra i co zechce zaimplementowac). Przyklad C
A442 XPIG-LATIN S XPIG-LATIN ow-nay
eaking-spay ig-pay atin-lay S A442 OK XPIG-LATIN
completed