CONTENT
- CHANGES
Szukaj
#top imapcmds¶
#top DESCRIPTION¶
imapcmds pozwala na nawiązywanie połączeń do serwerów IMAP/SIEVE/POP3/NNTP i wykonywanie wielu różnych operacji na serwerze włączając w to: nawiązanie połączenia czysto-tesktowego lub połączenia szyfrowanego z weryfikacją certyfikatu, autoryzacje (w obydwu przypadkach bez szyfrowania połączenia i z szyfrowaniem połączenia), oraz inne komendy zależne od wybranego protokołu.
Jedną z metod przekazywania hasła jest umieszenie jego w adresie URL. Niestety metoda ta ujawnia hasło każdemu, kto wyświetli listę procesów za pomocą np: "ps". Aby uchronić hasła przed podejrzeniem, należy zapisać je w pliku .netrc oraz za pomocą polecenia "chmod", ograniczyć dostęp do tego pliku tylko dla właściciela. Jeżeli hasła są bardzo ważne, nie należy go przechowywać w tym pliku na stałe, tylko dodać na czas wykonywania operacji i usunąć je z pliku natychmiast po zakończeniu wykonywania operacji na serwerze.
Jedną z metod przekazywania hasła jest umieszenie jego w adresie URL. Niestety metoda ta ujawnia hasło każdemu, kto wyświetli listę procesów za pomocą np: "ps". Aby uchronić hasła przed podejrzeniem, należy zapisać je w pliku .netrc oraz za pomocą polecenia "chmod", ograniczyć dostęp do tego pliku tylko dla właściciela. Jeżeli hasła są bardzo ważne, nie należy go przechowywać w tym pliku na stałe, tylko dodać na czas wykonywania operacji i usunąć je z pliku natychmiast po zakończeniu wykonywania operacji na serwerze.
#top Download¶
Download:
- Source: imapcmds (?,? kB),
- Linux: imapcmds (58,1 kB),
- OpenBSD: imapcmds-obsd (57,5 kB),
- FreeBSD: imapcmds-fbsd (59,5 kB),
- Solaris: imapcmds-sol (65,2 kB),
- BeOS: imapcmds-beos (70,7 kB),
- Windows: imapcmds.exe (81,1 kB),
#top SYNOPSIS¶
SYNOPSIS
imapcmds [OPTIONS] <command> <(imap[s]|sieve|pop3[s]|nntp[s])://[user[:pass]]@host[:port]/(mbname|group)[?sort=sorttype]> ...
#top OPTIONS¶
Opcje wspólne:
-d
-q
--syserrors
Wyświetlanie informacji diagnostycznych.
-q
Tryb cichy. Wyłącza dodatkowe informacje wyświetlane standardowo.
--syserrors
Wyświetlanie systemowych przyczyn błędów.
Opcje sieciowe:
--prefer-family=family
--inet4
--ipv4
--inet6
--ipv6
-w timeout-connect
-W timeout-connect
timeout-connect=timeout-connect
-T timeout-socket
--timeout-socket=timeout-socket
--bind-addr=ipaddr
--dnsqaddr=ipaddr
--dnsqtimeo=dnsq-timeout
--proxyurl=ipaddr
--proxytunnel
--proxysocks
--HAPROXYHELO=heloname
Wybór preferowanej rodziny adresów do której nazwy będą rozwiązywane, możliwie wartości dla family: AF_UNSPEC|AF_INET|AF_INET6 (default: AF_UNSPEC).
--inet4
--ipv4
Rozwiązywanie nazw tylko do adresów protokołu IPv4 (opcja równoznaczna do --prefer-family=AF_INET).
--inet6
--ipv6
Rozwiązywanie nazw tylko do adresów protokołu IPv6 (opcja równoznaczna do --prefer-family=AF_INET6).
-w timeout-connect
-W timeout-connect
timeout-connect=timeout-connect
Maksymalny czas oczekiwania na nawiązanie połączenia (domyślnie: 5.0). Dotyczy to tylko jednego serwera, w przypadku, gdy nazwa rozwiązuje się na 3 adresy IP, ten czas może być 3-krotnie dłuższy, jeśli połączenie z żadnym serwerem nie zakończy się sukcesem.
(-W - dla kompatybilności z innymi narzędziami sieciowymi).
(-W - dla kompatybilności z innymi narzędziami sieciowymi).
-T timeout-socket
--timeout-socket=timeout-socket
Maksymalny czas oczekiwania na wykonanie operacji sieciowych wysyłania i odbierania danych (domyślnie: --timeout-connect=5.0 --timeout-socket=90.0).
--bind-addr=ipaddr
Przypisanie lokalnego addresu IP przed nawiązywaniem połączenia do zdalnego serwera.
--dnsqaddr=ipaddr
Ustawienie adresu IP serwera nazw, który będzie używany do rozwiązywania nazw na adresy IP.
--dnsqtimeo=dnsq-timeout
Maksymalny czas oczekiwania na rozwiązanie nazwy na adres IP przez wskazany serwer nazw (stosowane z opcją --dnsqaddr=ipaddr).
--proxyurl=ipaddr
Używanie podanego adresu jako proxy do nawiązania połączenia z serwerem IMAP.
--proxytunnel
Nawiązanie połączenia tunelowanego przez proxy.
--proxysocks
Nawiązanie połączenia przez proxy socks.
--HAPROXYHELO=heloname
Nawiązanie połączenia do serwera obsługującego protokoły IMAP/SIEVE/POP3/NNTP przez serwer HAProxy poprzez wyłanie komendy HELO do serwera HAProxy przekazanej w argumencie heloname.
Opcje wyświetlania komend wysyłanych do serwera i zwracanych odpowiedzi:
--sock-send
--sock-recv
--sock-info
--comm-send
-S
--comm-recv
-R
--data-send
--data-recv
Włączenie wyświetlania pomocniczych informacji związanych z wysyłaniem danych.
--sock-recv
Włączenie wyświetlania pomocniczych informacji związanych z odbieraniem danych.
--sock-info
Włączenie wyświetlania pomocniczych informacji związanych z statusem wykonania wysłanych komend (metod).
--comm-send
-S
Włączenie wyświetlania komend (nagłówków) wysyłanych do serwera.
--comm-recv
-R
Włączenie wyświetlania komend (nagłówków) odbieranych od serwera.
--data-send
Włączenie wyświetlania wysyłanych danych (treści) powiązanych z komendami (nagłówkami).
--data-recv
Włączenie wyświetlania odbieranych danych (treści) powiązanych z komendami (nagłówkami).
Opcje TLS/SSL:
--ca-file=/etc/pki/tls/certs/ca-bundle.crt
--SNI=sniname
--starttls=TLSv13
--starttls=TLSv12
--starttls=TLSv11
--starttls=TLSv10
--starttls=SSLv3
--starttls
--tlsinfo
--certcheck-no
--certverify
--certinfo
--certshow
Ustawienie ścieżki do pliku zawierającego certyfikaty główne i pośrednie.
--SNI=sniname
Ustawia sniname jako SNI zamiast nazwy hosta z adresu URL.
--starttls=TLSv13
Wymuszenie nawiązania bezpiecznego połączenia z użyciem protokołu szyfrowania TLSv13.
--starttls=TLSv12
Wymuszenie nawiązania bezpiecznego połączenia z użyciem protokołu szyfrowania TLSv12.
--starttls=TLSv11
Wymuszenie nawiązania bezpiecznego połączenia z użyciem protokołu szyfrowania TLSv11.
--starttls=TLSv10
Wymuszenie nawiązania bezpiecznego połączenia z użyciem protokołu szyfrowania TLSv10.
--starttls=SSLv3
Wymuszenie nawiązania bezpiecznego połączenia z użyciem protokołu szyfrowania SSLv3.
--starttls
Wymuszenie nawiązania bezpiecznego połączenia z użyciem dowolnego protokołu szyfrowania.
--tlsinfo
Wyświetlenie informacji o nawiązanym połączeniu TLS/SSL (parametry szyfrowania):
Description - Opis protokołu TLS/SSL (Wersja - Zestaw Szyfrowania),
Session ID - Identyfikator Sesji,
Version - Wersja protokołu,
Cipher Suite - Zestaw Szyfrowania,
Key eXchange - Sposób wymiany kluczy,
Cipher - Szyfr,
MAC - Kod Uwierzytelnienia Wiadomości,
Compression - Kompresja używana w protokole TLS/SSL,
Session ID - Identyfikator Sesji,
Version - Wersja protokołu,
Cipher Suite - Zestaw Szyfrowania,
Key eXchange - Sposób wymiany kluczy,
Cipher - Szyfr,
MAC - Kod Uwierzytelnienia Wiadomości,
Compression - Kompresja używana w protokole TLS/SSL,
--certcheck-no
Weryfikacja Certyfikatu:
Zwrócenie kodu weryfikacji certyfikatu, umożliwiającego przerwanie połączenia w przypadku nie prawidłowego certyfikat (w przypadku podania tej opcji zostanie zwrócony kod oznaczający, że certyfikat jest prawidłowy, nawet w przypadku nie prawidłowego certyfikatu).
--certverify
Weryfikacja informacji w certyfikacie:
Sprawdzenie czy Wystawca certyfikatu jest zaufany
Sprawdzenie czy nazwa hosta w certyfikacie pasuje do nazwy hosta z którym nawiązano połączenie,
Wyświetlenie Wystawcy certyfikatu,
Wyświetlenie Podmiotu certyfikatu,
Sprawdzenie dat ważności certyfikatu,
Sprawdzenie czy nazwa hosta w certyfikacie pasuje do nazwy hosta z którym nawiązano połączenie,
Wyświetlenie Wystawcy certyfikatu,
Wyświetlenie Podmiotu certyfikatu,
Sprawdzenie dat ważności certyfikatu,
--certinfo
Informacje o certyfikacie X509:
Wyświetlenie wersji certyfikatu,
Wyświetlenie Numeru Seryjnego certyfikatu,
Wyświetlenie Sygnatury Argorytmu certyfikatu,
Wyświetlenie Wystawcy certyfikatu,
Wyświetlenie Podmiotu certyfikatu,
Wyświetlenie dat ważności certyfikatu,
Wyświetlenie informacji o Kluczu Publicznym,
Wyświetlenie Rozszerzeń certyfikatu,
Wyświetlenie Numeru Seryjnego certyfikatu,
Wyświetlenie Sygnatury Argorytmu certyfikatu,
Wyświetlenie Wystawcy certyfikatu,
Wyświetlenie Podmiotu certyfikatu,
Wyświetlenie dat ważności certyfikatu,
Wyświetlenie informacji o Kluczu Publicznym,
Wyświetlenie Rozszerzeń certyfikatu,
--certshow
Wyświetlenie certyfikatu w formacie PEM (Privacy Enhanced Mail).
Opcje różne:
--color=WHEN
--conn-retry-max=count
--conn-retry-wait=seconds
Kolorowanie wysyłanych komend i odbieranych statusów wykonania komend (nagłówków), WHEN może być jednym z: 'auto', 'always', 'never',
--conn-retry-max=count
Określenie maksymalnej ilości powtórzeń prób nawiązania połączenia na count w przypadku nieudanej próby nawiązania połączenia.
--conn-retry-wait=seconds
Oczekuje określoną ilość sekund podaną w argumencie seconds pomiędzy powtórzeniem pownego nawiązania połączenia.
Opcje protokołu IMAP:
--auth-type=METHOD
--half-open
--msgnum
--ftpeek
--comm-retry
--with-callback
--interval=seconds
--auto-expunge-deleted
--mbnamelist=mbnamelist
--mbdeledest=mbname
--auto-subscribe
--auto-half-open
--mbmovedest=mbname
--showpart=part
--idle-loop=seconds
--with-malloc
Ustawienie metody uwierzytelniania na METHOD, argument METHOD może być jednym z: LOGIN, PLAIN, CRAM-MD5, DIGEST-MD5, SCRAM-SHA-1, APOP, NTLM, RPA, ANONYMOUS, GSSAPI, OTP, SKEY,
--half-open
Nie otwieraj skrzynki pocztowej (przydatne w przypadkach np.: tworzenia/zmiany nazwy/usuwania/listowania skrzynek pocztowych). Skrzynka pocztowa jest otwierana przed wykonaniem jakiejkolwiek operacji, w przypadku nie powodzenia program kończy działanie i żadne operacje nie są wykonywane. Także użycie tej opcji jest wręcz niezbędne w przypadku tworzenia skrzynki pocztowej.
--msgnum
Używanie podanych argumentów jako numerów wiadomości zamiast używania jako unikalne identyfikatory wiadomości (UID).
--ftpeek
Pobieranie treści wiadomości z włączoną flagą FT_PEEK, dzięki czemu wiadomość nie jest automatycznie oznaczana jako przeczytana poprzez ustawienie flagi "\\Seen".
--comm-retry
Ponów próbę w przypadku zakończenia wykonywania określonych operacji niepowodzeniem,
--with-callback
Używanie funkcji wywoływanych zwrotnie podczas wykonywania określonych operacji,
--interval=seconds
Oczekuje określoną ilość sekund podaną w argumencie seconds pomiędzy wykonywaniem określonych operacji w pętli.
--auto-expunge-deleted
Włączenie automatycznego oczyszczania skrzynki pocztowej z usuniętych wiadomości po usunięciu wiadomości lub po ustawieniu flagi "\Deleted" dla wiadomości.
--mbnamelist=mbnamelist
Podanie listy nazw skrzynek pocztowych podczas wykonywania operacji tworzenia, usuwania, subskrybowania, cofania subskrybowania. Lista powinna wyglądać następująco: --mbnamelist="skrzynka-1|skrzynka-2|skrzynka-3"
--mbdeledest=mbname
Podanie nazwy skrzynki pocztowej, do której wiadomości są kopiowane/przenoszone a następnie kasowane, ponieważ niektóre serwery nie pozwalają na usuwanie wiadomości w bieżącej skrzynce pocztowej.
--auto-subscribe
Automatyczne subskrybowanie nowo utworzonej skrzynki pocztowej, cofanie subskrybowania usuwaniętej skrzynki pocztowej oraz cofanie subskrybowania starej nazwy skrzynki pocztowej i subskrybowanie nowej nazwy skrzynki pocztowej po zmianie nazwy.
--auto-half-open
Nie otwieraj (automatycznie) skrzynki pocztowej podczas wykonywania operacji tworzenia/zmiany nazwy/usuwania skrzynek pocztowych. Opcja analogiczna do --half-open i jest stosowana tylko w przypadku tworzenia/zmiany nazwy/usuwania skrzynek pocztowych. Podawanie opcji w wierszu poleceń może być zbyt uciążliwe toteż możliwe jest podanie tej opcji w pliku imapcmdsrc.
--mbmovedest=mbname
Podanie nazwy skrzynki pocztowej do której znalezione wiadomości zostaną przeniesione. Wyszukiwane wiadomości komendą msgssrch wraz z kryteriami domyślnie są wyświetlane w postaci listy wiadomości (analogicznie do msgslist). Po podaniu nazwy skrzynki pocztowej znalezione wiadomości nie zostaną wyświetlone tylko skopiowane do docelowej skrzynki pocztowej, a wiadomości w otwartej skrzynce pocztowej zostaną oznaczane są jako usunięte. Przy włączonej opcji --auto-expunge-deleted skasowane wiadomości mogą zostać automatycznie usunięte bez konieczności dodatkowo uruchamiania komendy expunge.
--showpart=part
???.
--idle-loop=seconds
Określenie maksymalnej ilości iteracji w stanie IDLE na wartość podaną w argumencie count pozostawiania w trybie IDLE.
--with-malloc
#top COMMANDS¶
komendy dostępne:
#top UTILS commands¶
Komendy różne:
noop
idle
capability
capa
help
Wysłanie instrukcji pustej do serwera. W programie uruchamianym z wiersza poleceń nie ma żadnego zastosowania, ale w innych aplikacjach utrzymujących połączenie do serwera przez dłuższy czas wysłanie pustej instrukcji pozwala sprawdzić czy połączenie jest aktywne oraz czy serwer odpowiada na wysyłane komendy.
idle
Wysłanie komendy zmieniającej stan połączenia na bezczynny (IDLE) do serwera. W programie uruchamianym z wiersza poleceń nie ma żadnego zastosowania, ale w innych aplikacjach utrzymujących połączenie do serwera przez dłuższy czas wysłanie komendy zmieniającej stan połączenia na bezczynny pozwala na otrzymywanie od serwera powiadomień o aktualizacji skrzynki pocztowej (dzięki temu nie ma potrzeby cyklicznego sprawdzania statusu skrzynki pocztowej).
capability
capa
help
Wyświetlenie możliwości (funkcjonalności) dostępnych (skonfigurowanych) na serwerze.
#top MAILBOX commands¶
Komendy do zarządzania skrzynkami pocztowymi:
mblist
mbsortlist
mbinfolist
mblsub
mbsortlsub
mbinfolsub
mbstatus
mbcreate
mbrename
mbdelete
mbsubscribe
mbunsubscribe
expunge
mbsortlist
mbinfolist
Wyświetlenie listy skrzynek pocztowych znajdujących na serwerze.
mbsortlist - wyświetlenie posortowanej listy skrzynek pocztowych. Kryteria sortowania podane są w następujący sposób:
imapcmds [...] mbsortlist "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'casesens', 'casenose', ordertype może być jednym z: 'asc', 'desc',
mbinfolist - wyświetlenie statusów z listy skrzynek pocztowych.
mbsortlist - wyświetlenie posortowanej listy skrzynek pocztowych. Kryteria sortowania podane są w następujący sposób:
imapcmds [...] mbsortlist "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'casesens', 'casenose', ordertype może być jednym z: 'asc', 'desc',
mbinfolist - wyświetlenie statusów z listy skrzynek pocztowych.
mblsub
mbsortlsub
mbinfolsub
Wyświetlenie listy subskrybowanych skrzynek pocztowych znajdujących na serwerze.
mbsortlsub - wyświetlenie posortowanej listy subskrybowanych skrzynek pocztowych. Kryteria sortowania podane są w następujący sposób:
imapcmds [...] mbsortlsub "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'casesens', 'casenose', ordertype może być jednym z: 'asc', 'desc',
mbinfolsub - wyświetlenie statusów z listy subskrybowanych skrzynek pocztowych.
mbsortlsub - wyświetlenie posortowanej listy subskrybowanych skrzynek pocztowych. Kryteria sortowania podane są w następujący sposób:
imapcmds [...] mbsortlsub "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'casesens', 'casenose', ordertype może być jednym z: 'asc', 'desc',
mbinfolsub - wyświetlenie statusów z listy subskrybowanych skrzynek pocztowych.
mbstatus
Wyświetlenie statusu skrzynki pocztowej, wyświetlenie następujących informacji: ilości wiadomości, ilości nowych wiadomości od ostatniego otwarcia, ilości wiadomości nie odczytanych (pobierane lecz niewyświetlane są również: następny identyfikator wiadomości, identyfikator ważności wiadomości).
mbcreate
Utworzenie skrzynki pocztowej. Wymaga użycia opcji jednej z opcji --half-open lub </strong>--auto-half-open</strong> w przeciwnym razie nastąpi próba otwarcia skrzynki pocztowej przed jej utworzenie i w przypadku nie powodzenia program zakończydziałanie. Sugerowane jest również użycie opcji --auto-subscribe w celu dodania utworzonej skrzynki pocztowej do subskrybowanych skrzynek pocztowych.
mbrename
Zmiana nazwy skrzynki pocztowej. Sugerowane jest użycie jednej z opcji --half-open lub --auto-half-open w celu nie otwierania skrzynki pocztowej której nazwa ulega zmianie oraz opcji --auto-subscribe w celu cofnięcia subskrybowania dla starej nazwy skrzynki pocztowej i dodania nowej nazwy skrzynki pocztowej do subskrybowanych skrzynek pocztowych.
imapcmds [...] mbrename "imap://user:pass@host/mbprevname" mbnextname
imapcmds [...] mbrename "imap://user:pass@host/mbprevname" mbnextname
mbdelete
Usunięcie skrzynki pocztowej. Sugerowane jest użycie jednej z opcji --half-open lub --auto-half-open w celu nie otwierania skrzynki pocztowej która ulega skasowaniu oraz opcji --auto-subscribe w celu cofnięcia subskrybowania dla usuwanej skrzynki pocztowej.
mbsubscribe
Subskrybowanie skrzynki pocztowej.
mbunsubscribe
Cofanie subskrybowania skrzynki pocztowej.
expunge
Oczyszczenie skrzynki pocztowej z usuniętych wiadomości po usunięciu wiadomości lub po ustawieniu flagi "\Deleted" dla wiadomości.
#top ACL commands¶
Komendy do zarządzania uprawnieniami (listami ACL - Access Control List):
getacl
setacl
deleteacl
listrights
myrights
Wyświetlenie uprawnień do skrzynki pocztowej.
setacl
Ustawienie uprawnień dla konta someuser do skrzynki pocztowej mbname.
imapcmds [...] setacl "imap://user:pass@host/mbname" someuser "acl-list"
listę uprawnień acl-list jakie można ustawić do skrzynki pocztowej mbname można uzyskać przy pomocy komendy listrights.
imapcmds [...] setacl "imap://user:pass@host/mbname" someuser "acl-list"
listę uprawnień acl-list jakie można ustawić do skrzynki pocztowej mbname można uzyskać przy pomocy komendy listrights.
deleteacl
Usunięcie uprawnień dla konta someuser do skrzynki pocztowej mbname.
imapcmds [...] deleteacl "imap://user:pass@host/mbname" someuser
imapcmds [...] deleteacl "imap://user:pass@host/mbname" someuser
listrights
Wyświetlenie listy uprawnień jakie mogą być ustawione dla konta do skrzynki pocztowej.
myrights
Wyświetlenie uprawnień dla obecnego konta do skrzynki pocztowej.
#top QUOTA commands¶
Komendy do zarządzania przydziałami (QUOTA):
getquotaroot
getquota
setquota
Wyświetlenie listy katalogów głównych przydziałów dla skrzynki pocztowej oraz listy zużycia zasobów i limitów zasobów dla każdego katalogu głównego.
imapcmds [...] getquotaroot "imap://user:pass@host/mbname"
imapcmds [...] getquotaroot "imap://user:pass@host/mbname"
getquota
Wyświetlenie dla katalogu głównego listy zużycia zasobów i limitów zasobów.
imapcmds [...] getquota "imap://user:pass@host/mbname" "account"
imapcmds [...] getquota "imap://user:pass@host/mbname" "account"
setquota
Ustawienie dla katalogu głównego limitów zasobów.
imapcmds [...] setquota "imap://user:pass@host/mbname" "account" "limits"
imapcmds [...] setquota "imap://user:pass@host/mbname" "account" "limits"
#top MESSAGES commands¶
Komendy do zarządzania wiadomościami:
msgslist
msgssort
msgsthread
msgssrch
setflag
clrflag
msgsseen
msgsunse
msgsdele
msgsunde
msgscopy
msgsmove
msgsshow
msgssave
msgsstruct
msgspart
showtext
showhtml
append
Wyświetlenie listy wiadomości. Wiadomości wyświetlane są w kolejności w jakiej zostały odebrane z serwera. Możliwe jest wyświetlenie wiadomości w posortowanej kolejności przy użyciu funkcji qsort(3). Kryteria sortowania podane są w następujący sposób:
imapcmds [...] msgslist "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'arrival', 'date' (domyślny), 'size', 'from', 'to', 'cc', 'subject', ordertype może być jednym z: 'asc', 'desc',
Domyślnie lista wiadomości wyświetlana jest w postaci analogicznej do poniższej:
uid=....1 SAFDRXF date=YYYY/mm/dd HH:MM:SS size=DDDDDDDDB subject=|Subject-Of-The-Message| from=|Sender-Of-The-Mes-sage <user@example.net>| to=|Recipient-Of-The-Message <user@example.org>|
Wyświetlenie listy wiadomości może być kontrolowane poprzez zmienne środowiskowe: IMAPCMDSFETCHFORMAT określająca format listy wiadomości, IMAPCMDSSIZEFORMAT określającą format rozmiaru wiadomości (format jest argumentem dla funkcji snprintf(3)), IMAPCMDSDATEFORMAT określającą format daty wiadomości (format jest argumentem dla strftime(3)),
imapcmds [...] msgslist "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'arrival', 'date' (domyślny), 'size', 'from', 'to', 'cc', 'subject', ordertype może być jednym z: 'asc', 'desc',
Domyślnie lista wiadomości wyświetlana jest w postaci analogicznej do poniższej:
uid=....1 SAFDRXF date=YYYY/mm/dd HH:MM:SS size=DDDDDDDDB subject=|Subject-Of-The-Message| from=|Sender-Of-The-Mes-sage <user@example.net>| to=|Recipient-Of-The-Message <user@example.org>|
Wyświetlenie listy wiadomości może być kontrolowane poprzez zmienne środowiskowe: IMAPCMDSFETCHFORMAT określająca format listy wiadomości, IMAPCMDSSIZEFORMAT określającą format rozmiaru wiadomości (format jest argumentem dla funkcji snprintf(3)), IMAPCMDSDATEFORMAT określającą format daty wiadomości (format jest argumentem dla strftime(3)),
msgssort
Wyświetlenie listy wiadomości posortowanej przez serwer. Posortowana lista wiadomości w postaci listy wiadomości wyświetlane są w analogiczny sposób jak przy msgslist. Kryteria sortowania podane są w następujący sposób:
imapcmds [...] msgssort "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'arrival', 'date' (domyślny), 'size', 'from', 'to', 'cc', 'subject', ordertype może być jednym z: 'asc', 'desc',
imapcmds [...] msgssort "imap://user:pass@host/mbname?sort=sorttype&order=ordertype"
sorttype może być jednym z: 'arrival', 'date' (domyślny), 'size', 'from', 'to', 'cc', 'subject', ordertype może być jednym z: 'asc', 'desc',
msgsthread
Wyświetlenie listy wiadomości w postaci wątków.
msgssrch
Wyświetlenie listy wiadomości znalezionych zgodnie z podanymi kryteriami. Znalezione wiadomości w postaci listy wiadomości wyświetlane są w analogiczny sposób jak przy msgslist. Kryteria wyszukiwania podane są w następujący sposób:
imapcmds [...] msgssrch "imap://user:pass@host/mbname" criteria
przy wyszukiwaniu wiadomości criteria zgodnie z RFC2060 powinno być podane analogicznie jak poniżej:
imapcmds [...] msgssrch "imap://user:pass@host/mbname" criteria
przy wyszukiwaniu wiadomości criteria zgodnie z RFC2060 powinno być podane analogicznie jak poniżej:
setflag
Ustawienie listy flag dla wiadomości lub listy wiadomości.
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "flag-list" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1:2,5,6:*"
ustawiane flagi podane w flag-list zgodnie z RFC2060 powinny być następujące: "\Seen", "\Answered", "\Flagged", "\Deleted", and "\Draft", dozwolone są również niestandardowe flagi np: $Forwarded.
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "flag-list" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1:2,5,6:*"
ustawiane flagi podane w flag-list zgodnie z RFC2060 powinny być następujące: "\Seen", "\Answered", "\Flagged", "\Deleted", and "\Draft", dozwolone są również niestandardowe flagi np: $Forwarded.
clrflag
Usunięcie listy flag dla wiadomości lub listy wiadomości.
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "flag-list" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1:2,5,6:*"
usuwane flagi podane w flag-list zgodnie z RFC2060 powinny być następujące: "\Seen", "\Answered", "\Flagged", "\Deleted", and "\Draft", dozwolone są również niestandardowe flagi np: $Forwarded.
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "flag-list" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1:2,5,6:*"
usuwane flagi podane w flag-list zgodnie z RFC2060 powinny być następujące: "\Seen", "\Answered", "\Flagged", "\Deleted", and "\Draft", dozwolone są również niestandardowe flagi np: $Forwarded.
msgsseen
Oznaczenie wiadomości lub listy wiadomości jako przeczytane (ustawienie flagi "\Seen" dla wiadomości lub listy wiadomości). Poniższe wywołania są równoznaczne:
imapcmds [...] msgsseen "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\\Seen" uid-list
imapcmds [...] msgsseen "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\\Seen" uid-list
msgsunse
Oznaczenie wiadomości lub listy wiadomości jako nieprzeczytane (usunięcie flagi "\Seen" dla wiadomości lub listy wiadomości). Poniższe wywołania są równoznaczne:
imapcmds [...] msgsunse "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\\Seen" uid-list
imapcmds [...] msgsunse "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\\Seen" uid-list
msgsdele
Oznaczenie wiadomości lub listy wiadomości jako skasowana (ustawienie flagi "\Deleted" dla wiadomości lub listy wiadomości). Poniższe wywołania są równoznaczne:
imapcmds [...] msgsdele "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\\Deleted" uid-list
imapcmds [...] msgsdele "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\\Deleted" uid-list
msgsunde
Oznaczenie wiadomości lub listy wiadomości jako nieskasowana (usunięcie flagi "\Deleted" dla wiadomości lub listy wiadomości). Poniższe wywołania są równoznaczne:
imapcmds [...] msgsunde "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\\Deleted" uid-list
imapcmds [...] msgsunde "imap://user:pass@host[:port]/mbname" uid-list
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\\Deleted" uid-list
msgscopy
Skopiowanie wiadomości lub listy wiadomościami do innej skrzynki pocztowej.
imapcmds [...] msgscopy "imap://user:pass@host[:port]/mbname" mbdest uid-list
imapcmds [...] msgscopy "imap://user:pass@host[:port]/mbname" mbdest uid-list
msgsmove
Przeniesienie wiadomości lub listy wiadomościami do innej skrzynki pocztowej. Przeniesienie wiadomości realizowane jest w dwóch etapach: skopiowanie wiadomości lub listy wiadomościami do innej skrzynki pocztowej, oznaczenie wiadomości lub listy wiadomości jako skasowana w bieżącej skrzynce pocztowej (ustawienie flagi "\Deleted" dla wiadomości lub listy wiadomości).
imapcmds [...] msgsmove "imap://user:pass@host[:port]/mbname" mbdest uid-list
imapcmds [...] msgsmove "imap://user:pass@host[:port]/mbname" mbdest uid-list
msgsshow
Wyświetlenie całej treści wiadomości wraz z nagłowkami i zawartością.
msgssave
Zapisanie całej treści wiadomości wraz z nagłowkami i zawartości do pliku. Ścieżka powinna być zakończona znakiem "/", wtedy do ścieżki zostanie doklejony identyfikator wiadomości i każda wiadomości zostanie zapisana w osobnym pliku o zawierającego w nazwie identyfikator wiadomości. Jeśli ścieżka nie będzie zakończona znakiem "/", wtedy każda wiadomość zostanie zapisane do tego pliku nadpisując poprzednią wiadomość (jeśli ścieżka będzie wskazywać na plik należy podać tylko jeden identyfikator wiadomości).
imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1[ uid2[ uid3[ ... uidN]]]
imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/file.eml uid1
imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1[ uid2[ uid3[ ... uidN]]]
imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/file.eml uid1
msgsstruct
Wyświetlenie struktury wiadomości (część tekstowa, część HTML, obrazy, załączniki).
msgspart
Zapisanie struktury wiadomości do plików (część tekstowa, część HTML, obrazy, załączniki).
imapcmds [...] msgspart "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1
imapcmds [...] msgspart "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1[ uid2[ uid3[ ... uidN]]]
imapcmds [...] msgspart "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1
imapcmds [...] msgspart "imap://user:pass@host[:port]/mbname" /path/to/dir/ uid1[ uid2[ uid3[ ... uidN]]]
showtext
Wyświetlenie treści tekstowej wiadomości wraz ze standardowymi nagłowkami (Data, Nadawca, Odbiorca, Temat).
showhtml
Wyświetlenie treści HTML wiadomości wraz ze standardowymi nagłowkami (Data, Nadawca, Odbiorca, Temat).
append
Dodanie (zapisanie) całej treści wiadomości wraz z nagłówków i zawartością do skrzynki pocztowej.
imapcmds [...] append "imap://user:pass@host[:port]/mbname" /path/to/file.eml[ /path/to/file.eml[ /path/to/file.eml[ ... /path/to/file.eml]]]
imapcmds [...] append "imap://user:pass@host[:port]/mbname" /path/to/file.eml[ /path/to/file.eml[ /path/to/file.eml[ ... /path/to/file.eml]]]
#top ENVIRONMENT VARIABLES¶
ZMIENNE ŚRODOWISKOWE
HOME
IMAPCMDSMBNAMESIZE
IMAPCMDSFETCHFORMAT
IMAPCMDSSIZEFORMAT
IMAPCMDSDATEFORMAT
Określa ścieżkę do katalogu domowego w którym znajduje się plik konfiguracyjny użytkownika.
IMAPCMDSMBNAMESIZE
Nazwa skrzynki pocztowej jest dopełniana z prawej strony znakami spacji do ilości podanej w IMAPCMDSMBNAMESIZE, co poprawia czytelność przy podczas wyświetlania informacji dotyczącej statusów skrzynek pocztowych.
IMAPCMDSFETCHFORMAT
Domyślnie lista wiadomości wyświetlana jest w postaci analogicznej do poniższej:
uid=....1 SAFDRXF date=YYYY/mm/dd HH:MM:SS size=DDDDDDDDB subject=|Subject-Of-The-Message| from=|Sender-Of-The-Message <user@example.net>| to=|Recipient-Of-The-Message <user@example.org>|
gdzie poprzedzony tekstem "uid=" wyświetlany jest unikalny identyfikator wiadomości dopełniony z lewej strony znakami spacji do 5 znaków,
następnie wyświetlane są pojedyncze litery oznaczające ustawione flagi wiadomości lub znak spacji (jeśli flaga nie jest ustawiona),
następnie poprzedzona tekstem "date=" wyświetlana jest data w formacie "YYYY/mm/dd HH:MM:SS",
następnie poprzedzony tekstem "size=" wyświetlany jest rozmiar wiadomości dopełniony z lewej strony znakami spacji do 8 znaków z literą B na końcu oznaczającą rozmiar w Bajtach,
następnie poprzedzony tekstem "subject=" wyświetlany jest temat wiadomości objęty znakami potoku,
następnie poprzedzony tekstem "from=" wyświetlany jest nadawca wiadomości objęty znakami potoku,
następnie poprzedzony tekstem "to=" wyświetlany jest odbiorca wiadomości objęty znakami potoku,
(w przypadku braku odbiorcy wiadomości ale występuje odbiorca kopii wiadomości po tekscie "cc=" zamiast "to=" wyświetlany jest odbiorca kopii wiadomości),
Format listy wiadomości może być kontrolowany poprzez zmienną IMAPCMDSFETCHFORMAT, rozpoznawane są następujące sekwencje formatujące:
%X - pojedyncze litery oznaczające flagi ustawione wiadomości lub znak spacji (jeśli flaga nie jest ustawiona), litery flag wiadomości mają następujące znaczenie: S/U - Odczytana/NieOdczytana (Seen/Unseen) A - Odpowiedziana(Answered) F - Oznaczona(Flagged) D - Usunięta(Deleted) R - NieWidziana(Recent) X - Szkic(Draft) F - Przesłana(Forwarded),
%U - unikalny identyfikator wiadomości,
%I - wewnętrzna data wiadomości,
%D - data wiadomości, format daty wiadomości może być kontrolowany przez zmienną IMAPCMDSDATEFORMAT,
%B - rozmiar wiadomości, rozmiar wiadomości może być kontrolowany przez zmienną IMAPCMDSSIZEFORMAT,
%S - temat wiadomości,
%F - nadawca wiadomości,
%T - odbiorca wiadomości,
%C - odbiorca kopii wiadomości,
%MID - identyfikator wiadomości (Message-ID),
%REF - identyfikator wiadomości odwołania (References),
uid=....1 SAFDRXF date=YYYY/mm/dd HH:MM:SS size=DDDDDDDDB subject=|Subject-Of-The-Message| from=|Sender-Of-The-Message <user@example.net>| to=|Recipient-Of-The-Message <user@example.org>|
gdzie poprzedzony tekstem "uid=" wyświetlany jest unikalny identyfikator wiadomości dopełniony z lewej strony znakami spacji do 5 znaków,
następnie wyświetlane są pojedyncze litery oznaczające ustawione flagi wiadomości lub znak spacji (jeśli flaga nie jest ustawiona),
następnie poprzedzona tekstem "date=" wyświetlana jest data w formacie "YYYY/mm/dd HH:MM:SS",
następnie poprzedzony tekstem "size=" wyświetlany jest rozmiar wiadomości dopełniony z lewej strony znakami spacji do 8 znaków z literą B na końcu oznaczającą rozmiar w Bajtach,
następnie poprzedzony tekstem "subject=" wyświetlany jest temat wiadomości objęty znakami potoku,
następnie poprzedzony tekstem "from=" wyświetlany jest nadawca wiadomości objęty znakami potoku,
następnie poprzedzony tekstem "to=" wyświetlany jest odbiorca wiadomości objęty znakami potoku,
(w przypadku braku odbiorcy wiadomości ale występuje odbiorca kopii wiadomości po tekscie "cc=" zamiast "to=" wyświetlany jest odbiorca kopii wiadomości),
Format listy wiadomości może być kontrolowany poprzez zmienną IMAPCMDSFETCHFORMAT, rozpoznawane są następujące sekwencje formatujące:
%X - pojedyncze litery oznaczające flagi ustawione wiadomości lub znak spacji (jeśli flaga nie jest ustawiona), litery flag wiadomości mają następujące znaczenie: S/U - Odczytana/NieOdczytana (Seen/Unseen) A - Odpowiedziana(Answered) F - Oznaczona(Flagged) D - Usunięta(Deleted) R - NieWidziana(Recent) X - Szkic(Draft) F - Przesłana(Forwarded),
%U - unikalny identyfikator wiadomości,
%I - wewnętrzna data wiadomości,
%D - data wiadomości, format daty wiadomości może być kontrolowany przez zmienną IMAPCMDSDATEFORMAT,
%B - rozmiar wiadomości, rozmiar wiadomości może być kontrolowany przez zmienną IMAPCMDSSIZEFORMAT,
%S - temat wiadomości,
%F - nadawca wiadomości,
%T - odbiorca wiadomości,
%C - odbiorca kopii wiadomości,
%MID - identyfikator wiadomości (Message-ID),
%REF - identyfikator wiadomości odwołania (References),
IMAPCMDSSIZEFORMAT
Określa format rozmiaru wiadomości (format jest argumentem dla funkcji snprintf(3)).
IMAPCMDSDATEFORMAT
Określa format daty wiadomości (format jest argumentem dla funkcji strftime(3)).
#top FILES¶
PLIKI
/etc/imapcmdsrc
$HOME/.imapcmdsrc
Globalny plik konfiguracyjny.
$HOME/.imapcmdsrc
Prywatny plik konfiguracyjny użytkownika.
#top SYNTAX imapcmdsrc¶
SKŁADNIA PLIKU imapcmdsrc
syserrors=WHEN
prefer-family=family
timeout-connect=seconds
timeout-socket=seconds
bind-addr=ipaddr
dnsqaddr=ipaddr
dnsqtimeo=dnsq-timeout
proxyurl=(imap[s]|sieve|pop3[s]|nntp[s])://[user[:pass]@]host[:port]/
proxytunnel=WHEN
proxysocks=WHEN
sock-send=WHEN
sock-recv=WHEN
sock-info=WHEN
comm-send=WHEN
comm-recv=WHEN
data-send=WHEN
data-recv=WHEN
ca-file=/etc/pki/tls/certs/ca-bundle.crt
tlsinfo=WHEN
certverify=WHEN
certinfo=WHEN
certshow=WHEN
color=WHEN
conn-retry-max=count
conn-retry-wait=seconds
auto-expunge-deleted=WHEN
auto-subscribe=WHEN
auto-half-open=WHEN
mbdeledest=mbname
idle-loop=seconds
with-malloc=WHEN
mbsort=sorttype
mborder=ordertype
sorttype=sorttype
sortorder=ordertype
Wyświetlanie systemowych przyczyn błędów, WHEN może być jednym z: '1', '0', 'on', 'off'.
prefer-family=family
Wybór preferowanej rodziny adresów do której nazwy będą rozwiązywane, możliwie wartości dla family: AF_UNSPEC|AF_INET|AF_INET6 (default: AF_UNSPEC).
timeout-connect=seconds
Maksymalny czas oczekiwania na nawiązanie połączenia (domyślnie: 5.0). Dotyczy to tylko jednego serwera, w przypadku, gdy nazwa rozwiązuje się na 3 adresy IP, ten czas może być 3-krotnie dłuższy, jeśli połączenie z żadnym serwerem nie zakończy się sukcesem.
timeout-socket=seconds
Maksymalny czas oczekiwania na wykonanie operacji sieciowych wysyłania i odbierania danych (domyślnie: timeout-socket=90.0).
bind-addr=ipaddr
Przypisanie lokalnego addresu IP przed nawiązywaniem połączenia do zdalnego serwera.
dnsqaddr=ipaddr
Ustawia adres IP serwera nazw, który będzie używany do rozwiązywania nazw na adresy IP.
dnsqtimeo=dnsq-timeout
Maksymalny czas oczekiwania na rozwiązanie nazwy na adres IP przez wskazany serwer nazw (stosowane z opcją dnsqaddr=ipaddr).
proxyurl=(imap[s]|sieve|pop3[s]|nntp[s])://[user[:pass]@]host[:port]/
Używanie podanego adresu jako proxy do nawiązania połączenia z serwerem IMAP.
proxytunnel=WHEN
Nawiązanie połączenia tunelowanego przez proxy, WHEN może być jednym z: '1', '0', 'on', 'off'.
proxysocks=WHEN
Nawiązanie połączenia przez proxy socks, \fIWHEN\fR może być jednym z: '1', '0', 'on', 'off', WHEN może być jednym z: '1', '0', 'on', 'off'.
sock-send=WHEN
Wyświetlanie pomocniczych informacji związanych z wysyłaniem danych, WHEN może być jednym z: '1', '0', 'on', 'off'.
sock-recv=WHEN
Wyświetlanie pomocniczych informacji związanych z odbieraniem danych, WHEN może być jednym z: '1', '0', 'on', 'off'.
sock-info=WHEN
Wyświetlanie pomocniczych informacji związanych z statusem wykonania wysłanych komend (metod), WHEN może być jednym z: '1', '0', 'on', 'off'.
comm-send=WHEN
Wyświetlanie komend (nagłówków) wysyłanych do serwera, WHEN może być jednym z: '1', '0', 'on', 'off'.
comm-recv=WHEN
Wyświetlanie komend (nagłówków) odbieranych od serwera, WHEN może być jednym z: '1', '0', 'on', 'off'.
data-send=WHEN
Wyświetlanie wysyłanych danych (treści) powiązanych z komendami (nagłówkami), WHEN może być jednym z: '1', '0', 'on', 'off'.
data-recv=WHEN
Wyświetlanie odbieranych danych (treści) powiązanych z komendami (nagłówkami), WHEN może być jednym z: '1', '0', 'on', 'off'.
ca-file=/etc/pki/tls/certs/ca-bundle.crt
Ustawienie ścieżki do pliku zawierającego certyfikaty główne i pośrednie.
tlsinfo=WHEN
Wyświetlenie informacji o nawiązanym połączeniu TLS/SSL (parametry szyfrowania), WHEN może być jednym z: '1', '0', 'on', 'off'.
certverify=WHEN
Weryfikacja informacji w certyfikacie, WHEN może być jednym z: '1', '0', 'on', 'off'.
certinfo=WHEN
Informacje o certyfikacie X509, WHEN może być jednym z: '1', '0', 'on', 'off'.
certshow=WHEN
Wyświetlenie certyfikatu w formacie PEM (Privacy Enhanced Mail), WHEN może być jednym z: '1', '0', 'on', 'off'.
color=WHEN
Kolorowanie wysyłanych komend i odbieranych statusów wykonania komend (nagłówków), WHEN może być jednym z: 'auto', 'always', 'never'.
conn-retry-max=count
Określenie maksymalnej ilości powtórzeń prób nawiązania połączenia na count w przypadku nieudanej próby nawiązania połączenia.
conn-retry-wait=seconds
Oczekuje określoną ilość sekund podaną w argumencie seconds pomiędzy powtórzeniem pownego nawiązania połączenia.
auto-expunge-deleted=WHEN
Włączenie automatycznego oczyszczania skrzynki pocztowej z usuniętych wiadomości po usunięciu wiadomości lub po ustawieniu flagi "\Deleted" dla wiadomości, WHEN może być jednym z: '1', '0', 'on', 'off'.
auto-subscribe=WHEN
Automatyczne subskrybowanie nowo utworzonej skrzynki pocztowej, cofanie subskrybowania usuwaniętej skrzynki pocztowej oraz cofanie subskrybowania starej nazwy skrzynki pocztowej i subskrybowanie nowej nazwy skrzynki pocztowej po zmianie nazwy, WHEN może być jednym z: '1', '0', 'on', 'off'.
auto-half-open=WHEN
Nie otwieraj skrzynki pocztowej podczas wykonywania operacji tworzenia/zmiany nazwy/usuwania skrzynek pocztowych, WHEN może być jednym z: '1', '0', 'on', 'off'.
mbdeledest=mbname
Podanie nazwy skrzynki pocztowej, do której wiadomości są kopiowane/przenoszone, ponieważ niektóre serwery nie pozwalają na usuwanie wiadomości w bieżącej skrzynce pocztowej.
idle-loop=seconds
Określenie maksymalnej ilości iteracji w stanie IDLE na wartość podaną w argumencie count pozostawiania w trybie IDLE.
with-malloc=WHEN
Używanie funkcji w wersji z alokacją pamięci przy użyciu malloc() oraz realloc() dla zwracanych danych o wielkości, która jest bardzo trudna do przewidzenia, aby alokować pamięc przed wywołaniem funkcji, WHEN może być jednym z: '1', '0', 'on', 'off'..
mbsort=sorttype
sorttype może być jednym z: 'casesens', 'casenose'.
mborder=ordertype
ordertype może być jednym z: 'asc', 'desc'.
sorttype=sorttype
sorttype może być jednym z: 'arrival', 'date' (domyślny), 'size', 'from', 'to', 'cc', 'subject'.
sortorder=ordertype
ordertype może być jednym z: 'asc', 'desc'.
#top SEE ALSO¶
ZOBACZ TAKŻE
libsocknet(3) libsocktls(3) libimap(3) libsmtp(3) libhttp(3) libftp(3) libtftp(3)
imapcmds(1) smtpsend(1) httprecv(1) httpexec(1) ftpdcmds(1) tftpcmds(1)
imapcmds(1) smtpsend(1) httprecv(1) httpexec(1) ftpdcmds(1) tftpcmds(1)
#top EXAMPLES¶
Przykłady przedstawiono w analogicznej kolejności do opisanych powyżej komend.
Wyświetlenie listy skrzynek pocztowych (posortowanych, statusów):
Wyświetlenie listy subskrybowanych skrzynek pocztowych (posortowanych, statusów):
Utworzenie skrzynki pocztowej mbname:
Zmiana nazwy skrzynki pocztowej z mbprevname na mbnextname:
Usunięcie skrzynki pocztowej mbname:
Subskrybowanie skrzynki pocztowej mbname:
Cofanie subskrybowania skrzynki pocztowej mbname:
Wyświetlenie listy wiadomości (posortowanej według daty rosnąco).
Wyświetlenie listy wiadomości posortowanej przez serwer według daty rosnąco.
Wyświetlenie listy wiadomości znalezionych zgodnie z podanymi kryteriami.
Przeniesienie listy wiadomości znalezionych zgodnie z podanymi kryteriami do docelowej skrzynki pocztowej.
Ustawienie listy flag dla listy wiadomości.
Usunięcie listy flag dla listy wiadomości.
Oznaczenie listy wiadomości jako przeczytane (ustawienie flagi "\Seen" dla listy wiadomości).
Oznaczenie listy wiadomości jako nieprzeczytane (usunięcie flagi "\Seen" dla listy wiadomości).
Oznaczenie listy wiadomości jako skasowane (oczyszczenie skrzynki z wiadomości usuniętych oraz przeniesienie wiadomości do skrzynki docelowej i skasowanie wiadomości w skrzynce docelowej).
Oznaczenie listy wiadomości jako nieskasowana (usunięcie flagi "\Deleted" dla listy wiadomości).
Skopiowanie listy wiadomościami do innej skrzynki pocztowej.
Przeniesienie wiadomości lub listy wiadomościami do innej skrzynki pocztowej.
Wyświetlenie całej treści wiadomości wraz z nagłowkami i zawartością.
Zapisanie całej treści wiadomości wraz z nagłowkami i zawartości do pliku (zapisanie podanych wiadomości do katalogu w plikach o podanych numerach wiadomości).
Zapisanie struktury wiadomości do plików (część tekstowa, część HTML, obrazy, załączniki).
Dodanie (zapisanie) całej treści wiadomości wraz z nagłówkami i zawartością do skrzynki pocztowej.
Wyświetlenie listy skrzynek pocztowych (posortowanych, statusów):
imapcmds [...] mblist "imap://user:pass@host/mbname" imapcmds [...] mbsortlist "imap://user:pass@host[:port]/mbname?sort=casenose&order=asc" imapcmds [...] mbinfolist "imap://user:pass@host[:port]/mbname"
Wyświetlenie listy subskrybowanych skrzynek pocztowych (posortowanych, statusów):
imapcmds [...] mblsub "imap://user:pass@host/mbname" imapcmds [...] mbsortlsub "imap://user:pass@host[:port]/mbname?sort=casenose&order=asc" imapcmds [...] mbinfolsub "imap://user:pass@host[:port]/mbname"
Utworzenie skrzynki pocztowej mbname:
imapcmds [...] mbcreate --half-open --auto-subscribe "imap://user:pass@host[:port]/mbname"
Zmiana nazwy skrzynki pocztowej z mbprevname na mbnextname:
imapcmds [...] mbrename --half-open --auto-subscribe "imap://user:pass@host[:port]/mbprevname" mbnextname
Usunięcie skrzynki pocztowej mbname:
imapcmds [...] mbdelete --half-open --auto-subscribe "imap://user:pass@host[:port]/mbname"
Subskrybowanie skrzynki pocztowej mbname:
imapcmds [...] mbsubscribe "imap://user:pass@host[:port]/mbname"
Cofanie subskrybowania skrzynki pocztowej mbname:
imapcmds [...] mbsubscribe "imap://user:pass@host[:port]/mbname"
Wyświetlenie listy wiadomości (posortowanej według daty rosnąco).
imapcmds [...] msgslist "imap://user:pass@host[:port]/mbname" imapcmds [...] msgslist "imap://user:pass@host[:port]/mbname?sort=date&order=asc"
Wyświetlenie listy wiadomości posortowanej przez serwer według daty rosnąco.
imapcmds [...] msgssort "imap://user:pass@host[:port]/mbname?sort=date&order=asc"
Wyświetlenie listy wiadomości znalezionych zgodnie z podanymi kryteriami.
# wyszukiwanie przy użyciu kryteriów: NAGŁÓWEK o nazwie fieldname zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "HEADER fieldname \"string\"" # wyszukiwanie przy użyciu kryteriów: NAGŁÓWEK From zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "HEADER From \"string\"" # wyszukiwanie przy użyciu kryteriów: NAGŁÓWEK To zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "HEADER To \"string\"" # wyszukiwanie przy użyciu kryteriów: NAGŁÓWEK Cc zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "HEADER Cc \"string\"" # wyszukiwanie przy użyciu kryteriów: NAGŁÓWEK Subject zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "HEADER Subject \"string\"" # wyszukiwanie przy użyciu kryteriów: NADAWCA zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "FROM \"string\"" # wyszukiwanie przy użyciu kryteriów: ODBIORCA zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "TO \"string\"" # wyszukiwanie przy użyciu kryteriów: ODBIORCA-KOPII zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "CC \"string\"" # wyszukiwanie przy użyciu kryteriów: TEMAT zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "SUBJECT \"string\"" # wyszukiwanie przy użyciu kryteriów: TREŚĆ zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "BODY \"string\"" # wyszukiwanie przy użyciu kryteriów: TREŚĆ-TEKSTOWA zawiera ciąg znaków "string" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "TEXT \"string\"" # wyszukiwanie przy użyciu kryteriów: po dacie "08-Mar-2019" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "SINCE \"08-Mar-2019\"" # wyszukiwanie przy użyciu kryteriów: przed datą "08-Mar-2019" imapcmds [...] msgssrch "imap://user:pass@host[:port]/mbname" "BEFORE \"08-Mar-2019\""
Przeniesienie listy wiadomości znalezionych zgodnie z podanymi kryteriami do docelowej skrzynki pocztowej.
imapcmds [...] --mbmovedest=mbdest msgssrch "imap://user:pass@host[:port]/mbname" "HEADER Subject \"subject\""
Ustawienie listy flag dla listy wiadomości.
imapcmds [...] setflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1,2,5:6,8:*"
Usunięcie listy flag dla listy wiadomości.
imapcmds [...] clrflag "imap://user:pass@host[:port]/mbname" "\Seen \Answered \Flagged \Deleted \Draft $Forwarded" "1,2,5:6,8:*"
Oznaczenie listy wiadomości jako przeczytane (ustawienie flagi "\Seen" dla listy wiadomości).
imapcmds [...] msgsseen "imap://user:pass@host[:port]/mbname" "1,2,5:6,8:*"
Oznaczenie listy wiadomości jako nieprzeczytane (usunięcie flagi "\Seen" dla listy wiadomości).
imapcmds [...] msgsunse "imap://user:pass@host[:port]/mbname" "1,2,5:6,8:*"
Oznaczenie listy wiadomości jako skasowane (oczyszczenie skrzynki z wiadomości usuniętych oraz przeniesienie wiadomości do skrzynki docelowej i skasowanie wiadomości w skrzynce docelowej).
imapcmds [...] msgsdele "imap://user:pass@host[:port]/mbname" "1,2,5:6,8:*" imapcmds [...] msgsdele --auto-expunge-deleted "imap://user:pass@host/mbname" "1,2,5:6,8:*" imapcmds [...] msgsdele --mbdeledest=DATA/Trash "imap://user:pass@host/mbname" "1,2,5:6,8:*"
Oznaczenie listy wiadomości jako nieskasowana (usunięcie flagi "\Deleted" dla listy wiadomości).
imapcmds [...] msgsunde "imap://user:pass@host[:port]/mbname" "1,2,5:6,8:*"
Skopiowanie listy wiadomościami do innej skrzynki pocztowej.
imapcmds [...] msgscopy "imap://user:pass@host[:port]/mbname" mbdest "1,2,5:6,8:*"
Przeniesienie wiadomości lub listy wiadomościami do innej skrzynki pocztowej.
imapcmds [...] msgsmove "imap://user:pass@host[:port]/mbname" mbdest "1,2,5:6,8:*"
Wyświetlenie całej treści wiadomości wraz z nagłowkami i zawartością.
imapcmds [...] msgsshow "imap://user:pass@host[:port]/mbname" 1
Zapisanie całej treści wiadomości wraz z nagłowkami i zawartości do pliku (zapisanie podanych wiadomości do katalogu w plikach o podanych numerach wiadomości).
imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/file.eml 1 imapcmds [...] msgssave "imap://user:pass@host[:port]/mbname" /path/to/dir/ 1 2 5 6 8 9
Zapisanie struktury wiadomości do plików (część tekstowa, część HTML, obrazy, załączniki).
imapcmds [...] msgspart "imap://user:pass@host[:port]/mbname" /path/to/part/ 1
Dodanie (zapisanie) całej treści wiadomości wraz z nagłówkami i zawartością do skrzynki pocztowej.
imapcmds [...] append "imap://user:pass@host[:port]/mbname" /path/to/file-1.eml /path/to/file-2.eml /path/to/file-3.eml
Przykład:
imapcmds -w 5 --comm-send --comm-recv --sock-info --half-open capability imap://imap.yandex.ru/
imapcmds: Resolving imap.yandex.ru ... 2a02:6b8::125, 77.88.21.125 Success imapcmds: Connecting to imap.yandex.ru[2a02:6b8::125]:143 ... Failed, Reason: 101:Network is unreachable imapcmds: Connecting to imap.yandex.ru[77.88.21.125]:143 ... Success imapcmds: Connect:OK(imap.yandex.ru:): result=1 Connected to imap.yandex.ru[77.88.21.125]:143 * OK Yandex IMAP4rev1 at vla1-177b375dac7f.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42276, 2019-Sep-18 17:24:51, oOQkVA0W64Y1 imapcmds: BANNER:OK result=148 buffdata=|* OK Yandex IMAP4rev1 at vla1-177b375dac7f.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42276, 2019-Sep-18 17:24:51, oOQkVA0W64Y1| imapcmds: BANNER:OK * OK Yandex IMAP4rev1 at vla1-177b375dac7f.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42276, 2019-Sep-18 17:24:51, oOQkVA0W64Y1 DONE CAPABILITY * CAPABILITY IMAP4rev1 CHILDREN UNSELECT LITERAL+ NAMESPACE XLIST BINARY UIDPLUS ENABLE ID STARTTLS LOGINDISABLED AUTH=XOAUTH2 IDLE MOVE DONE OK CAPABILITY Completed. imapcmds: CAPABILITY/CAPA/HELP:OK result=169 buffdata=|* CAPABILITY IMAP4rev1 CHILDREN UNSELECT LITERAL+ NAMESPACE XLIST BINARY UIDPLUS ENABLE ID STARTTLS LOGINDISABLED AUTH=XOAUTH2 IDLE MOVE| imapcmds: CAPABILITY/CAPA/HELP:OK CAPABILITY IMAP4rev1 CHILDREN UNSELECT LITERAL+ NAMESPACE XLIST BINARY UIDPLUS ENABLE ID STARTTLS LOGINDISABLED AUTH=XOAUTH2 IDLE MOVE DONE LOGOUT * BYE IMAP4rev1 Server logging out DONE OK LOGOUT completed imapcmds: LOGOUT:OK result=1 sstatus=|DONE OK LOGOUT completed| imap://@imap.yandex.ru:143/ dnsq=0.007, conn=0.063, bann=0.107, starttls=0.000, socktls=0.000, auth=0.000, quit=0.068, comm=0.393, summ=0.852, size=0, speed=0, SH=30 SB=0 RH=379, RB=0, result=0:DONE OK LOGOUT completed
Przykład:
imapcmds -w 5 --comm-send --comm-recv --sock-info --ca-file=/etc/pki/tls/certs/ca-bundle.crt --starttls --tlsinfo --certcheck-no --certverify --certinfo --half-open noop imap://imap.yandex.ru/
imapcmds: Resolving imap.yandex.ru ... 2a02:6b8::125, 77.88.21.125 Success imapcmds: Connecting to imap.yandex.ru[2a02:6b8::125]:143 ... Failed, Reason: 101:Network is unreachable imapcmds: Connecting to imap.yandex.ru[77.88.21.125]:143 ... Success imapcmds: Connect:OK(imap.yandex.ru:): result=1 Connected to imap.yandex.ru[77.88.21.125]:143 * OK Yandex IMAP4rev1 at sas2-ffb0c61c65da.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42275, 2019-Sep-18 17:22:31, SMQpFN0PWW21 imapcmds: BANNER:OK result=148 buffdata=|* OK Yandex IMAP4rev1 at sas2-ffb0c61c65da.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42275, 2019-Sep-18 17:22:31, SMQpFN0PWW21| imapcmds: BANNER:OK * OK Yandex IMAP4rev1 at sas2-ffb0c61c65da.qloud-c.yandex.net:143 ready to talk with ::ffff:89.231.96.70:42275, 2019-Sep-18 17:22:31, SMQpFN0PWW21 DONE STARTTLS DONE OK STARTTLS completed. imapcmds: STARTTLS:OK result=1 sstatus=|DONE OK STARTTLS completed.| imapcmds: STARTTLS:OK imapcmds: TLS/SSL connection established to imap://@imap.yandex.ru:/ imapcmds: TLS/SSL-SOCK:OK Started result=1 imap->ssl=0xfe07e60 imapcmds: TLS:LAYER: Description: (TLS1.2-PKIX)-(ECDHE-RSA-SECP256R1)-(AES-256-GCM)-(AEAD) imapcmds: TLS:LAYER: Session ID: AB:53:1F:71:58:31:25:7E:27:A2:64:71:28:44:39:A0:AF:0F:E3:10:E5:82:AF:3B:12:0B:60:58:F4:E6:BD:A8 imapcmds: TLS:LAYER: Ephemeral EC Diffie-Hellman parameters imapcmds: TLS:LAYER: Using curve: SECP256R1 imapcmds: TLS:LAYER: Curve size: 256 bits imapcmds: TLS:LAYER: Version: TLS1.2 imapcmds: TLS:LAYER: Cipher Suite: ECDHE_RSA_AES_256_GCM_SHA384 imapcmds: TLS:LAYER: Key eXchange: ECDHE-RSA imapcmds: TLS:LAYER: Cipher: AES-256-GCM imapcmds: TLS:LAYER: MAC: AEAD imapcmds: TLS:LAYER: Compression: NULL imapcmds: TLS:LAYER: Server Signature: RSA-SHA256 imapcmds: TLS:LAYER: Channel binding 'tls-unique': 8e00d3c6c67fc9fbe4fcc8a2 imapcmds: CERT:VERIFY: Peer's certificate is signed by Trusted Root Certification Authorities imapcmds: CERT[0]:VERIFY: The hostname in the certificate match 'imap.yandex.ru' imapcmds: CERT[0]:VERIFY: Issuer : C=RU,O=Yandex LLC,OU=Yandex Certification Authority,CN=Yandex CA imapcmds: CERT[0]:VERIFY: Subject: C=RU,O=Yandex LLC,OU=ITO,L=Moscow,ST=Russian Federation,CN=imap.yandex.ru imapcmds: CERT[0]:VERIFY: CERT:DATE:OK Validity: Not Before: 2019/04/01 15:46:01 imapcmds: CERT[0]:VERIFY: CERT:DATE:OK Validity: Not After : 2020/03/31 15:46:01 imapcmds: CERT[0]:VERIFY: CERT:DATE:OK Validity: Cert expire after 194 [d] (16845809 [s])) imapcmds: CERT[0]:VERIFY: X509v3 Subject Alternative Name: (not critical) imapcmds: CERT[0]:VERIFY: DNSname: imap.yandex.ru, DNSname: imap.yandex.kz, DNSname: imap.yandex.ua, DNSname: imap.yandex.com.tr, DNSname: imap.yandex.by, DNSname: imap.ya.ru, DNSname: imap.yandex.com, imapcmds: CERT[0]:X.509: Version: 3 imapcmds: CERT[0]:X.509: Serial Number (hex): 79:C5:CE:9F:E1:5E:0A:0C:FD:58:31:F7:89:E0:3F:77 imapcmds: CERT[0]:X.509: Signature Algorithm: RSA-SHA256 imapcmds: CERT[0]:X.509: Issuer : C=RU,O=Yandex LLC,OU=Yandex Certification Authority,CN=Yandex CA imapcmds: CERT[0]:X.509: Subject: C=RU,O=Yandex LLC,OU=ITO,L=Moscow,ST=Russian Federation,CN=imap.yandex.ru imapcmds: CERT[0]:X.509: Validity: Not Before: 2019/04/01 15:46:01 imapcmds: CERT[0]:X.509: Validity: Not After : 2020/03/31 15:46:01 imapcmds: CERT[0]:X.509: Subject Public Key Info: Public Key Algorithm: RSA (2048 bits) imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.ru imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.kz imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.ua imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.com.tr imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.by imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.ya.ru imapcmds: CERT[0]:X.509: Extensions: Subject Alternative Name: (not critical) DNSname: imap.yandex.com imapcmds: CERT[0]:X.509: Extensions: Basic Constraints: (critical) CA:FALSE imapcmds: CERT[0]:X.509: Extensions: Key usage: (critical) Digital signature. imapcmds: CERT[0]:X.509: Extensions: Key usage: (critical) Key encipherment. imapcmds: CERT[0]:X.509: Extensions: Key purpose OIDs:(not critical) TLS WWW Server. imapcmds: CERT[0]:X.509: Extensions: Key purpose OIDs:(not critical) TLS WWW Client. imapcmds: CERT[0]:X.509: Extensions: Other Information: MD5 fingerprint: 12098eb744de6f6b042bc38baaed9953 imapcmds: CERT[0]:X.509: Extensions: Other Information: SHA-1 fingerprint: 0739482789c02fedc28a79e51ac6cadf4fb3f461 imapcmds: CERT[0]:X.509: Extensions: Other Information: Public Key Id: 941fa33174a2a8ada25c54191290dcd0220e3d9b DONE NOOP DONE OK NOOP Completed. imapcmds: NOOP:OK result=1 sstatus=|DONE OK NOOP Completed.| DONE LOGOUT * BYE IMAP4rev1 Server logging out DONE OK LOGOUT completed imapcmds: LOGOUT:OK result=1 sstatus=|DONE OK LOGOUT completed| imap://@imap.yandex.ru:143/ dnsq=0.005, conn=0.083, bann=0.123, starttls=0.067, socktls=0.220, auth=0.000, quit=0.071, comm=0.068, summ=1.176, size=0, speed=0, SH=39 SB=0 RH=264, RB=0, result=0:DONE OK LOGOUT completed
Zmodyfikowany ostatnio: 2020/07/11 09:53:09 (3 lata temu),
textsize: 61,8 kB,
htmlsize: 75,4 kB
Zapraszam do komentowania, zgłaszania sugestii, propozycji, własnych przykładów, ...
Dodaj komentarzKomentarze użytkowników