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

RFC-775 : http://www.g6ftpserver.com/files/rfc775.txt
RFC-959 : http://www.g6ftpserver.com/files/rfc959.txt
RFC-2228 : http://www.g6ftpserver.com/files/rfc2228.txt
RFC-2389 : http://www.g6ftpserver.com/files/rfc2389.txt
RFC-2428 : http://www.g6ftpserver.com/files/rfc2428.txt
RFC-2577 : http://www.g6ftpserver.com/files/rfc2577.txt

Здесь приведён список поддерживаемых программой 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
  

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