Глава XVI - Документы



 1 - Запросы на комментарии (RFC)



 2 - Команды FTP


Здесь приведён список поддерживаемых программой Gene6 FTP Server команд FTP.


ABOR

Прекратить текущую операцию передачи.

Ответы сервера :


  • 226 ABOR command successful.



ALLO size

Возвращает ответ, если клиент может хранить size байт на сервере.

Ответы сервера :


  • 200 ALLO Ok : %d bytes available.
  • 501 Insufficient disk space : only %d bytes available.
  • 501 Required size parameter bad or missing.



APPE pathname

Возобновить передачу файла с именем pathname.

Ответы сервера:


  • 200 Ready to append file "%s" at offset %d.
  • 501 Bad or missing parameters.
  • 521 Data connection cannot be opened with this PROT setting.
  • 550 No port specified.
  • 550 Cannot APPE. No permission.
  • 550 Cannot APPE. (file not found or busy)



AUTH SSL|TLS-P|TLS|TLS-C [RFC-2228]

Установить SSL-зашифрованную сессию.

Ответы сервера :


  • 234 AUTH command ok; starting SSL connection.
  • 431 AUTH service unavailable.
  • 431 Bad or missing parameters.
  • 534 AUTH command is disabled.



CDUP

Перейти в родительский каталог.

Ответы сервера :


  • 250 CWD command successful. "%s" is current directory.
  • 550 CWD failed. "%s" : no such file or directory.
  • 550 CWD failed. No permission.
  • 550 CWD failed. %s



CLNT clientname

Известить сервер о названии приложения клиента.

Ответы сервера:

  • 200 Noted.



CWD pathname

Изменить каталог на pathname.

Ответы сервера :


  • 250 CWD command successful. "%s" is current directory.
  • 550 CWD failed. "%s" : no such file or directory.
  • 550 CWD failed. No permission.
  • 550 CWD failed. %s



DELE pathname

Удалить файл pathname.

Ответы сервера :


  • 250 File "%s" deleted.
  • 450 File "%s" can't be deleted.
  • 550 "%s": no such file.
  • 550 Cannot DELE. No permission.



EPRT |net-prt|net-addr|tcp-port| [RFC-2428]
(sample : EPRT |1|132.235.1.2|6275|)

Настроить порт для данных.

Ответы сервера :


  • 200 Port command successful.
  • 501 Invalid PORT command.
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.
  • 522 Network protocol not supported, use (%s)



EPSV net-prt [RFC-2428]

Настроить порт для данных.

Ответы сервера :


  • 229 Entering Extended Passive Mode (%s)
  • 501 PASV not allowed.
  • 501 PASV exception: "Please try again later.".
  • 522 Network protocol not supported, use (%s)



FEAT [RFC-2389]

Ответ - список команд FEAT.

Ответы сервера :



  • 211-Extensions supported:
    AUTH TLS
    PBSZ
    PROT
    CLNT
    COMPRESSION NONE*;ZLIB;
    MDTM
    MLST type*;size*;created;modify;
    PASV
    REST STREAM
    SIZE
    TVFS
    UTF8
    XCRC "filename" SP EP
    XMD5 "filename" SP EP
    211 End.



HELP

Вывести справку по поддерживаемым командам.

Ответы сервера :



  • 214-Supported Commands : (* unimplemented)
    ABOR FEAT PASS RMD STOU* XMD5
    ACCT* HELP PASV RNFR STRU XMKD
    ALLO LIST PORT RNTO SYST XPWD
    APPE MDTM PWD SITE TYPE XRMD
    CDUP MKD QUIT SIZE USER
    CLNT MODE REIN SMNT* XCRC
    CWD NLST REST STAT XCUP
    DELE NOOP RETR STOR XDEL
    SITE PSWD
    SITE ZONE
    214 End.



LIST [sp pathname]

Вывести перечень файлов каталога.

Ответы сервера :


  • 150 Data connection accepted from %s:%d; transfer starting.
  • 150 Opening data connection for directory list.
  • 550 No port specified.



MDTM [YYYYmmDDhhMMss] pathname

Изменить/получить время изменения файла pathname.

Ответы сервера :


  • 213 %s
  • 501 Bad or missing parameters.
  • 550 "%s" : can''t change date/time. No permission.
  • 550 "%s" : no such file or directory.



MKD pathname

Создать каталог pathname.

Ответы сервера :


  • 257 "%s": directory created.
  • 501 Bad or missing parameters.
  • 550 "%s": file or directory already exists.
  • 550 "%s": can't create directory.
  • 550 "%s": can't create directory. No permission.



MLSD [pathname]

Вывести перечень файлов каталога.

Ответы сервера :


  • 150 Data connection accepted from %s:%d; transfer starting.
  • 150 Opening data connection for directory list.
  • 550 No port specified.



MLST [pathname]

Получить статус текущего файла .

Ответы сервера :


  • (example)
    250-Begin
    type=dir;modify=19990930152225; /
    250 End.
  • 550 Permission denied.



MODE mode

Получить статус текущего файла .

Ответы сервера :


  • 200 Mode %s ok.
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



NLST

Вывести перечень файлов каталога.

Ответы сервера :


  • 150 Data connection accepted from %s:%d; transfer starting.
  • 150 Opening data connection for directory list.
  • 550 No port specified.



NOOP

Команда холостой операции.

Ответы сервера :


  • 200 NOOP command successful.



OPTS [RFC-2389]

Настроить опции команды.

Ответы сервера :


  • 200 %s OPTS %s
  • 501 Unknown option.
  • 501 Invalid %s options.



PASS password

Передать пароль.

Ответы сервера :


  • 230 User %s logged in.
  • 421 Can't login : invalid Home Directory.
  • 421 Not logged in, account expired.
  • 421 Service not available, closing control connection.
  • 421 Too many users logged for this account. Try again later.
  • 421 Not logged in, access denied.
  • 421 No more connection allowed for this IP.
  • 421 Login or Password incorrect.
  • 501 Bad or missing parameters.
  • 503 Login with USER first.



PASV

Команда pasv.

Ответы сервера :


  • 227 Entering Passive Mode (xxx,xxx,xxx,xxx,yyy,zzz).
  • 501 PASV not allowed.
  • 501 PASV exception: "Please try again later.".



PBSZ 0

Установить размер буфера защиты.

Ответы сервера :


  • 200 PBSZ=0
  • 501 Bad or missing parameters.
  • 503 Security data exchange not yet completed.



PORT host-port
(пример : PORT 192,168,0,1,4,0)

Настроить порт для данных.

Ответы сервера :


  • 200 Port command successful.
  • 501 Invalid PORT command.
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



PROT mode

Установить Протокол передачи данных.
Режим может быть следующим : 'C', 'P', 'S', 'E'. Если установлен режим 'P', то передача данных приватна.

Ответы сервера :


  • 200 PROT command successful.
  • 504 Command not implemented for the specified argument.



PWD

Распечатать текущий каталог.

Ответы сервера :


  • 257 "%s" is current directory.



QUIT

Завершить сессию клиента и закрыть соединение.

Ответы сервера :


  • 221 Goodbye.



REIN

Позволить клинету снова войти на сервер. Для простоты : клиент должен отключиться.

Ответы сервера :


  • 502 Disconnect first to re-login.



REST position

Перезапустить следующую операцию передачи с позиции position.

Ответы сервера :


  • 200 Restarting at %d. Send STORE or RETRIEVE.
  • 501 Required byte offset parameter bad or missing.



RETR pathname

Получить файл pathname.

Ответы сервера :


  • 150 Opening data connection for %s (%d bytes).
  • 501 Bad or missing parameters.
  • 521 Data connection cannot be opened with this PROT setting.
  • 550 "%s": No Such File.
  • 550 Cannot retrieve.
  • 550 Cannot RETR. Not enough credit.
  • 550 Cannot RETR. No permission.
  • 550 No port specified.



RMD pathname

Удалить каталог pathname.

Ответы сервера :


  • 200 "%s": directory removed.
  • 501 Bad or missing parameters.
  • 550 "%s": no such directory.
  • 550 "%s": can't remove directory. No permission.
  • 550 "%s": "%s": can't remove directory. %s



RNFR pathname

Начать операцию переименования/перемещения файла/каталога pathname.

Ответы сервера :


  • 350 File exists, ready for destination name.
  • 501 Bad or missing parameters.
  • 550 Cannot RNFR. No permission.
  • 550 "%s": no such file or directory.



RNTO pathname

Переименовать/переместить файл/каталог в pathname.

Ответы сервера :


  • 250 File "%s" renamed to "%s".
  • 501 Bad or missing parameters.
  • 503 Bad sequence of commands.
  • 550 File "%s" can't be renamed.
  • 550 "%s": no such file or directory.



SITE MSG message

Отправить сообщение администратору.

Ответы сервера :


  • 200 Message sent to administrator.



SITE PSWD oldpassword newpassword

Изменить пароль учётной записи.

Ответы сервера :


  • 200 Password change successful.
  • 501 Password not changed. No permission.
  • 501 Password not changed. Syntax : SITE PSWD
  • 501 Password not changed. Old password does not match.



SITE ZONE

Возвращает временной пояс сервера.

Ответы сервера :


  • 200 +-timezone.



SIZE pathname

Отобразить размер pathname.

Ответы сервера :


  • 213 %d.
  • 501 Bad or missing parameters.
  • 550 No such file or directory.
  • 550 Command failed: %s.



SMNT pathname

Данная команда позволяет пользователю смонтировать иную структуру данных файловой системы без изменения логина или информации учётной записи. Параметры передачи подобным образом не изменяются. Аргумент команды - путь (pathname), указывающий на каталог или иную системно-зависимую группу файлов.
Эта команда не поддерживается.

Ответы сервера :


  • 202 SMNT : Command not implemented, superfluous at this site.



STAT pathname

Эта команда приведёт к отправке отчёта о статусе по контрольному подключению в форме ответа.

Ответы сервера :



  • 211-
    FTP Server status for :
    (client ip : client port <-> server ip : server port)
    Files Downloaded: 0
    Downloaded: 0 Bytes
    Files Uploaded: 0
    211 Uploaded: 0 Bytes



STOR pathname

Закачать файл pathname.

Ответы сервера :


  • 150 Opening data connection for %s.
  • 426 Insufficient Disk Quota. Transfer of "%s" Aborted.
  • 501 Bad or missing parameters.
  • 521 Data connection cannot be opened with this PROT setting.
  • 550 Cannot STOR. %s
  • 550 Cannot STOR. No permission.
  • 550 No port specified.



STOU

Эта команда действует как STOR, за исключением того, что результирующий файл будет создан в текущем каталоге под уникальным для этого каталога именем.

Ответы сервера :


  • 502 STOU : Command not yet implemented.



STRU structure

Аргумент команды - единичный код символа Telnet, определяющий структуру файла, описанную в Разделе по Представлению и Хранению Данных.
Следующие коды задаются для структуры:
F - File (no record structure)
R - Record structure
P - Page structure

Структура по умолчанию - File.

Ответы сервера :


  • 200 STRU F ok.
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



SYST

Ответы сервера :


  • 215 UNIX Type: L8



TYPE type

Ответы сервера :


  • 200 Type set to %s.
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



USER username

Ответы сервера :


  • 331 Password required for %s.
  • 421 Too many users connected. Try again later.
  • 501 Bad or missing parameters.
  • 501 Disconnect first to re-login.
  • 501 Please AUTH first.



XCRC "filename" SP EP

Вычисляет контрольную сумму CRC32 файла filename от SP до EP.
SP - Начальная точка в байтах
EP - Конечная точка в байтах

Ответы сервера :


  • 250
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



XCUP [RFC-775]

Перейти в родимтельский каталог.

Ответы сервера :


  • 250 CWD command successful. "%s" is current directory.
  • 550 CWD failed. "%s" : no such file or directory.
  • 550 CWD failed. No permission.
  • 550 CWD failed. %s



XMD5 "filename" SP EP

Вычисляет контрольную сумму MD5 файла filename от SP до EP.
SP - Начальная точка в байтах
EP - Конечная точка в байтах

Ответы сервера :


  • 250
  • 501 Bad or missing parameters.
  • 504 Command not implemented for the specified argument.



XMKD pathname [RFC-775]

Создать каталог pathname.

Ответы сервера :


  • 257 "%s": directory created.
  • 501 Bad or missing parameters.
  • 550 "%s": file or directory already exists.
  • 550 "%s": can't create directory.
  • 550 "%s": can't create directory. No permission.



XPWD [RFC-775]

Распечатать текущий рабочий каталог

Ответы сервера :


  • 257 "%s" is current directory.



XRMD pathname [RFC-775]

Удалить каталог pathname.

Ответы сервера :


  • 200 "%s": directory removed.
  • 501 Bad or missing parameters.
  • 550 "%s": no such directory.
  • 550 "%s": can't remove directory. No permission.
  • 550 "%s": "%s": can't remove directory. %s

 3 - Часто встречающиеся проблемы


См. Часто задаваемые вопросы (FAQ) : http://www.G6FTPServer.com/?page=faq