Blame SOURCES/0001-Improve-documentation-of-ascii_-options.patch

993209
From a423831f25396c54f92cdfc6f92a104ed77c2ee6 Mon Sep 17 00:00:00 2001
993209
From: =?UTF-8?q?Ond=C5=99ej=20Lyson=C4=9Bk?= <olysonek@redhat.com>
993209
Date: Fri, 24 Nov 2017 11:26:37 +0100
993209
Subject: [PATCH] Improve documentation of ascii_* options
993209
993209
Resolves: rhbz#1517227
993209
---
993209
 vsftpd.conf   |  3 ++-
993209
 vsftpd.conf.5 | 20 ++++++++++++++++++++
993209
 2 files changed, 22 insertions(+), 1 deletion(-)
993209
993209
diff --git a/vsftpd.conf b/vsftpd.conf
993209
index 39d1955..acbc1e9 100644
993209
--- a/vsftpd.conf
993209
+++ b/vsftpd.conf
993209
@@ -73,7 +73,8 @@ xferlog_std_format=YES
993209
 #
993209
 # By default the server will pretend to allow ASCII mode but in fact ignore
993209
 # the request. Turn on the below options to have the server actually do ASCII
993209
-# mangling on files when in ASCII mode.
993209
+# mangling on files when in ASCII mode. The vsftpd.conf(5) man page explains
993209
+# the behaviour when these options are disabled.
993209
 # Beware that on some FTP servers, ASCII support allows a denial of service
993209
 # attack (DoS) via the command "SIZE /big/file" in ASCII mode. vsftpd
993209
 # predicted this attack and has always been safe, reporting the size of the
993209
diff --git a/vsftpd.conf.5 b/vsftpd.conf.5
993209
index d1f0db5..b6ddf05 100644
993209
--- a/vsftpd.conf.5
993209
+++ b/vsftpd.conf.5
993209
@@ -113,11 +113,31 @@ Default: YES
993209
 .TP
993209
 .B ascii_download_enable
993209
 When enabled, ASCII mode data transfers will be honoured on downloads.
993209
+When disabled, the server will pretend to allow ASCII mode but in fact
993209
+ignore requests to activate it. So the client will think the ASCII mode
993209
+is active and therefore may still translate any
993209
+.BR <CRLF>
993209
+character sequences in the received file. See the following article for
993209
+a detailed explanation of the behaviour:
993209
+https://access.redhat.com/articles/3250241.
993209
+
993209
+Turn this option on to have the server actually do
993209
+ASCII mangling on files when in ASCII mode.
993209
 
993209
 Default: NO
993209
 .TP
993209
 .B ascii_upload_enable
993209
 When enabled, ASCII mode data transfers will be honoured on uploads.
993209
+When disabled, the server will pretend to allow ASCII mode but in fact
993209
+ignore requests to activate it. So the client will think the ASCII mode
993209
+is active and will translate native line terminators to the standard
993209
+.BR <CRLF>
993209
+line terminators for transmission, but the server will not do
993209
+any translation. See the following article for a detailed explanation
993209
+of the behaviour: https://access.redhat.com/articles/3250241.
993209
+
993209
+Turn this option on to have the server actually do
993209
+ASCII mangling on files when in ASCII mode.
993209
 
993209
 Default: NO
993209
 .TP
993209
-- 
993209
2.14.3
993209