Lista kodów zwrotnych serwera FTP - List of FTP server return codes

Kody powrotne serwera FTP mają zawsze trzy cyfry, a każda cyfra ma specjalne znaczenie. Pierwsza cyfra oznacza, czy odpowiedź jest dobra, zła czy niekompletna:

Zasięg Cel, powód
1xx Pozytywna odpowiedź wstępna

Żądana akcja jest inicjowana; oczekuj kolejnej odpowiedzi, zanim przejdziesz do nowego polecenia. (Wysłanie przez proces użytkownika kolejnej komendy przed odpowiedzią na zakończenie byłoby niezgodne z protokołem; ale procesy serwera FTP powinny kolejkować wszelkie polecenia, które nadejdą w trakcie wykonywania poprzedniego polecenia). Tego typu odpowiedzi można użyć do wskazania, że polecenie zostało zaakceptowane i proces użytkownika może teraz zwrócić uwagę na połączenia danych, w przypadku wdrożeń, w których jednoczesne monitorowanie jest trudne. Proces serwera FTP może wysłać maksymalnie jedną odpowiedź 1xx na polecenie.

2xx Pozytywna odpowiedź dotycząca zakończenia

Żądana akcja została pomyślnie zakończona. Może zostać zainicjowane nowe żądanie.

3xx Pozytywna odpowiedź pośrednia

Polecenie zostało zaakceptowane, ale żądane działanie jest wstrzymane do czasu otrzymania dalszych informacji. Użytkownik powinien wysłać kolejną komendę określającą te informacje. Ta odpowiedź jest używana w grupach sekwencji poleceń.

4xx Przejściowa negatywna odpowiedź dotycząca zakończenia

Polecenie nie zostało zaakceptowane i żądana akcja nie została wykonana, ale stan błędu jest tymczasowy i można zażądać akcji ponownie. Użytkownik powinien powrócić do początku sekwencji poleceń, jeśli taka istnieje. Trudno jest przypisać znaczenie określeniu „przejściowy”, zwłaszcza gdy dwie różne witryny (procesy serwera i użytkownika) muszą uzgodnić interpretację. Każda odpowiedź w kategorii 4xx może mieć nieco inną wartość czasu, ale intencją jest to, aby proces użytkownika był zachęcany do ponownej próby. Praktyczna reguła określająca, czy odpowiedź pasuje do kategorii 4xx czy 5xx (Permanent Negative) jest taka, że ​​odpowiedzi mają wartość 4xx, jeśli polecenia można powtórzyć bez jakiejkolwiek zmiany w formie polecenia lub we właściwościach użytkownika lub serwera (np. polecenie jest zapisywane tak samo z tymi samymi argumentami, które zostały użyte; użytkownik nie zmienia dostępu do pliku ani nazwy użytkownika; serwer nie wprowadza nowej implementacji).

5xx Stała negatywna odpowiedź dotycząca ukończenia

Polecenie nie zostało zaakceptowane, a żądana akcja nie została wykonana. Odradza się procesowi użytkownika powtarzanie dokładnego żądania (w tej samej kolejności). Nawet niektóre „trwałe” błędy mogą zostać naprawione, więc użytkownik może chcieć skierować swój proces użytkownika do ponownego zainicjowania sekwencji poleceń przez bezpośrednie działanie w pewnym momencie w przyszłości (np. Po zmianie pisowni lub po zmianie pisowni przez użytkownika zmienił status swojego katalogu).

6xx Chroniona odpowiedź

RFC 2228 wprowadził pojęcie chronionych odpowiedziach na zwiększenie bezpieczeństwa na przestrzeni komunikacji FTP. Odpowiedzi 6xx to chronione wiadomości zakodowane algorytmem Base64, które służą jako odpowiedzi na bezpieczne polecenia. Odpowiedzi te, gdy zostaną prawidłowo zdekodowane, należą do powyższych kategorii.

Druga cyfra jest cyfrą grupującą i koduje następujące informacje:

Zasięg Cel, powód
x0x Składnia

Odpowiedzi te odnoszą się do błędów składniowych, poprawnych składniowo poleceń, które nie pasują do żadnej kategorii funkcjonalnej, niezaimplementowanych lub zbędnych poleceń.

x1x Informacja

Są to odpowiedzi na prośby o informacje, takie jak status lub pomoc.

x2x Znajomości

Odpowiedzi dotyczące połączeń sterujących i transmisji danych.

x3x Uwierzytelnianie i księgowość

Odpowiedzi na proces logowania i procedury księgowe.

x4x Nieokreślony w RFC 959 .
x5x System plików

Te odpowiedzi wskazują stan systemu plików serwera względem żądanego transferu lub innej akcji systemu plików.

Poniżej znajduje się lista wszystkich znanych kodów powrotu, które mogą być wysyłane przez serwer FTP.

Kod Wyjaśnienie
100 Series Żądana akcja jest inicjowana, przed wykonaniem nowego polecenia należy spodziewać się kolejnej odpowiedzi.
110 Zrestartuj odtwarzanie znacznika. W tym przypadku tekst jest dokładny i nie jest pozostawiony konkretnej implementacji; musi brzmieć: MARK yyyy = mmmmgdzie yyyy to znacznik strumienia danych procesu użytkownika i równoważny znacznik serwera mmmm (zwróć uwagę na odstępy między znacznikami i „=”).
120 Usługa gotowa w ciągu nnn minut.
125 Połączenie danych jest już otwarte; rozpoczęcie transferu.
150 Stan pliku w porządku; zaraz otworzy połączenie danych.
200 Series Żądana akcja została pomyślnie zakończona.
202 Polecenie niezaimplementowane, zbędne w tej witrynie.
211 Stan systemu lub odpowiedź pomocy systemu.
212 Stan katalogu.
213 Stan pliku.
214 Wiadomość pomocy. Wyjaśnia, jak korzystać z serwera lub znaczenie określonego niestandardowego polecenia. Ta odpowiedź jest przydatna tylko dla użytkownika.
215 Typ systemu NAZWA. Gdzie NAZWA to oficjalna nazwa systemu z rejestru prowadzonego przez IANA .
220 Usługa gotowa dla nowego użytkownika.
221 Usługa zamykająca połączenie sterujące.
225 Połączenie danych otwarte; brak transferu w toku.
226 Zamykanie połączenia danych. Żądane działanie na pliku powiodło się (na przykład przesłanie pliku lub przerwanie pliku).
227 Wejście w tryb pasywny (h1, h2, h3, h4, p1, p2).
228 Wejście w tryb Long Passive (długi adres, port).
229 Wchodzę w rozszerzony tryb pasywny (port ||| |).
230 Użytkownik zalogowany, kontynuuj. W razie potrzeby wylogowany.
231 Użytkownik wylogowany; usługa zakończona.
232 Zapisano polecenie wylogowania, zakończy się po zakończeniu przesyłania.
234 Określa, że ​​serwer akceptuje mechanizm uwierzytelniania określony przez klienta i że wymiana danych zabezpieczeń została zakończona. Niestandardowy kod wyższego poziomu stworzony przez firmę Microsoft .
250 Żądana akcja na pliku jest prawidłowa, zakończona.
257 Utworzono „PATHNAME”.
300 Series Polecenie zostało zaakceptowane, ale żądane działanie jest wstrzymane i oczekuje na dalsze informacje.
331 Nazwa użytkownika w porządku, potrzebne hasło.
332 Potrzebujesz konta do logowania.
350 Zażądano akcji w oczekiwaniu na dalsze informacje
400 Series Polecenie nie zostało zaakceptowane i żądana akcja nie została wykonana, ale stan błędu jest tymczasowy i można zażądać akcji ponownie.
421 Usługa niedostępna, zamykanie połączenia sterującego. Może to być odpowiedź na dowolne polecenie, jeśli usługa wie, że musi zostać zamknięta.
425 Nie można otworzyć połączenia danych.
426 Połączenie zamknięte; transfer przerwany.
430 Nieprawidłowa nazwa użytkownika lub hasło
434 Żądany host jest niedostępny.
450 Żądane działanie na pliku nie zostało podjęte.
451 Żądana czynność została przerwana. Lokalny błąd podczas przetwarzania.
452 Żądane działanie nie zostało podjęte. Za mało miejsca w systemie. Plik niedostępny (np. Plik zajęty).
500 Series Błąd składni, polecenie nierozpoznane i żądana akcja nie została wykonana. Może to obejmować błędy, takie jak zbyt długi wiersz poleceń.
501 Błąd składni w parametrach lub argumentach.
502 Polecenie nie zostało zaimplementowane.
503 Zła sekwencja poleceń.
504 Polecenie nie zostało zaimplementowane dla tego parametru.
530 Nie zalogowany.
532 Potrzebujesz konta do przechowywania plików.
534 Nie można połączyć się z serwerem - zasada wymaga SSL
550 Żądane działanie nie zostało podjęte. Plik niedostępny (np. Nie znaleziono pliku, brak dostępu).
551 Żądana czynność została przerwana. Typ strony nieznany.
552 Żądane działanie na pliku zostało przerwane. Przekroczony przydział pamięci (dla bieżącego katalogu lub zbioru danych).
553 Żądane działanie nie zostało podjęte. Niedozwolona nazwa pliku.
600 Series Odpowiedzi dotyczące poufności i integralności
631 Odpowiedź chroniona integralnością.
632 Odpowiedź chroniona poufnością i integralnością.
633 Odpowiedź chroniona poufnością.
10000 Series Typowe kody błędów Winsock (nie są to kody powrotu FTP)
10054 Połączenie zresetowane przez partnera. Połączenie zostało przymusowo zamknięte przez zdalnego hosta.
10060 Nie można połączyć się ze zdalnym serwerem.
10061 Nie można połączyć się ze zdalnym serwerem. Połączenie jest aktywnie odrzucane przez serwer.
10066 Katalog nie jest pusty.
10068 Zbyt wielu użytkowników, serwer jest pełny.

Zobacz też

Bibliografia