File 2598-ftp-Socket-options.patch of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 2598-ftp-Socket-options.patch of Package erlang (Revision 5ba44adc315be86a36b194034819d9be)

Currently displaying revision 5ba44adc315be86a36b194034819d9be , Show latest

From 55fcfd11890423cf77a2486223dede13cfdb9807 Mon Sep 17 00:00:00 2001
From: Hans Nilsson <hans@erlang.org>
Date: Mon, 18 Jun 2018 18:41:54 +0200
Subject: [PATCH 1/2] ftp: Socket options

---
 lib/inets/doc/src/ftp.xml |   8 ++-
 lib/inets/src/ftp/ftp.erl | 126 +++++++++++++++++++++++++++-------------------
 2 files changed, 82 insertions(+), 52 deletions(-)

diff --git a/lib/inets/doc/src/ftp.xml b/lib/inets/doc/src/ftp.xml
index 42bece4d38..126f415e81 100644
--- a/lib/inets/doc/src/ftp.xml
+++ b/lib/inets/doc/src/ftp.xml
@@ -548,11 +548,12 @@
 	<v>start_option() = {verbose, verbose()} | {debug, debug()}</v>
 	<v>verbose() = boolean() (default is false)</v>
 	<v>debug() = disable | debug | trace (default is disable)</v>
-	<v>open_option() = {ipfamily, ipfamily()} | {port, port()} | {mode, mode()} | {tls, tls_options()} | {timeout, timeout()} | {dtimeout, dtimeout()} | {progress, progress()}</v>
+	<v>open_option() = {ipfamily, ipfamily()} | {port, port()} | {mode, mode()} | {tls, tls_options()} | {timeout, timeout()} | {dtimeout, dtimeout()} | {progress, progress() | {sock_ctrl, sock_opts()} | {sock_data_act, sock_opts()} | {sock_data_pass, sock_opts()} }</v>
 	<v>ipfamily() = inet | inet6 | inet6fb4 (default is inet)</v>
 	<v>port() = integer() > 0 (default is 21)</v>
 	<v>mode() = active | passive (default is passive)</v>
 	<v>tls_options() = [<seealso marker="ssl:ssl#type-ssloption">ssl:ssloption()</seealso>]</v>
+	<v>sock_opts() = [<seealso marker="kernel:gen_tcp#type-option">gen_tcp:option()</seealso> except for ipv6_v6only, active, packet, mode and header</v>
 	<v>timeout() = integer() > 0 (default is 60000 milliseconds)</v>
 	<v>dtimeout() = integer() > 0 | infinity (default is infinity)</v>
 	<v>pogress() = ignore | {module(), function(), initial_data()} (default is ignore)</v>
@@ -575,6 +576,11 @@
 	is used for securing both the control connection and the data sessions.
 	
 
+	The options <c>sock_ctrl</c>, <c>sock_data_act</c> and <c>sock_data_pass</c> passes options down to 
+	the underlying transport layer (tcp). The default value for <c>sock_ctrl</c> is <c>[]</c>. Both 
+	<c>sock_data_act</c> and <c>sock_data_pass</c> uses the value of <c>sock_ctrl</c> as default value.
+	
+
 A session opened in this way is closed using function
 <seealso marker="#close">close</seealso>.
 
diff --git a/lib/inets/src/ftp/ftp.erl b/lib/inets/src/ftp/ftp.erl
index e0430654eb..7509339eec 100644
--- a/lib/inets/src/ftp/ftp.erl
+++ b/lib/inets/src/ftp/ftp.erl
@@ -94,6 +94,9 @@
 	 %% data needed further on.
 	 caller = undefined, % term() 
 	 ipfamily, % inet | inet6 | inet6fb4
+ sockopts_ctrl = [],
+ sockopts_data_passive = [],
+ sockopts_data_active = [],
 	 progress = ignore, % ignore | pid()	 
 	 dtimeout = ?DATA_ACCEPT_TIMEOUT, % non_neg_integer() | infinity
 	 tls_upgrading_data_connection = false,
@@ -138,9 +141,10 @@ open({option_list, Options}) when is_list(Options) ->
 try
 	{ok, StartOptions} = start_options(Options),
 	{ok, OpenOptions} = open_options(Options), 
+	{ok, SockOpts} = socket_options(Options),
 	case ftp_sup:start_child([[[{client, self()} | StartOptions], []]]) of
 	 {ok, Pid} ->
-		call(Pid, {open, ip_comm, OpenOptions}, plain);
+		call(Pid, {open, ip_comm, OpenOptions, SockOpts}, plain);
 	 Error1 ->
 		Error1
 	end
@@ -168,9 +172,11 @@ open(Host, Opts) when is_list(Opts) ->
 	?fcrt("open", [{start_options, StartOptions}]), 
 	{ok, OpenOptions} = open_options([{host, Host}|Opts]), 
 	?fcrt("open", [{open_options, OpenOptions}]), 
+	{ok, SocketOptions} = socket_options(Opts),
+	?fcrt("open", [{socket_options, SocketOptions}]), 
 	case start_link(StartOptions, []) of
 	 {ok, Pid} ->
-		do_open(Pid, OpenOptions, tls_options(Opts));
+		do_open(Pid, OpenOptions, SocketOptions, tls_options(Opts));
 	 Error1 ->
 		?fcrt("open - error", [{error1, Error1}]), 
 		Error1
@@ -181,8 +187,8 @@ open(Host, Opts) when is_list(Opts) ->
 	 Error2
 end.
 
-do_open(Pid, OpenOptions, TLSOpts) ->
- case call(Pid, {open, ip_comm, OpenOptions}, plain) of
+do_open(Pid, OpenOptions, SocketOptions, TLSOpts) ->
+ case call(Pid, {open, ip_comm, OpenOptions, SocketOptions}, plain) of
 	{ok, Pid} ->
 	 maybe_tls_upgrade(Pid, TLSOpts);
 	Error ->
@@ -879,9 +885,10 @@ start_standalone(Options) ->
 try
 	{ok, StartOptions} = start_options(Options),
 	{ok, OpenOptions} = open_options(Options), 
+	{ok, SocketOptions} = socket_options(Options),
 	case start_link(StartOptions, []) of
 	 {ok, Pid} ->
-		call(Pid, {open, ip_comm, OpenOptions}, plain);
+		call(Pid, {open, ip_comm, OpenOptions, SocketOptions}, plain);
 	 Error1 ->
 		Error1
 	end
@@ -893,10 +900,11 @@ start_standalone(Options) ->
 start_service(Options) ->
 try
 	{ok, StartOptions} = start_options(Options),
-	{ok, OpenOptions} = open_options(Options), 
+	{ok, OpenOptions} = open_options(Options),
+	{ok, SocketOptions} = socket_options(Options),
 	case ftp_sup:start_child([[[{client, self()} | StartOptions], []]]) of
 	 {ok, Pid} ->
-		call(Pid, {open, ip_comm, OpenOptions}, plain);
+		call(Pid, {open, ip_comm, OpenOptions, SocketOptions}, plain);
 	 Error1 ->
 		Error1
 	end
@@ -1041,6 +1049,33 @@ open_options(Options) ->
 	 {ftp_extension, ValidateFtpExtension, false, ?FTP_EXT_DEFAULT}], 
 validate_options(Options, ValidOptions, []).
 
+
+
+socket_options(Options) ->
+ CtrlOpts = proplists:get_value(sock_ctrl, Options, []),
+ DataActOpts = proplists:get_value(sock_data_act, Options, CtrlOpts),
+ DataPassOpts = proplists:get_value(sock_data_pass, Options, CtrlOpts),
+ case [O || O <- lists:usort(CtrlOpts++DataPassOpts++DataActOpts),
+ not valid_socket_option(O)] of
+ [] ->
+ {ok, {CtrlOpts, DataPassOpts, DataActOpts}};
+ Invalid ->
+ throw({error,{sock_opts,Invalid}})
+ end.
+
+
+valid_socket_option(inet ) -> false;
+valid_socket_option(inet6 ) -> false;
+valid_socket_option({ipv6_v6only, _}) -> false;
+valid_socket_option({active,_} ) -> false;
+valid_socket_option({packet,_} ) -> false;
+valid_socket_option({mode,_} ) -> false;
+valid_socket_option(binary ) -> false;
+valid_socket_option(list ) -> false;
+valid_socket_option({header,_} ) -> false;
+valid_socket_option(_) -> true.
+
+
 tls_options(Options) ->
 %% Options will be validated by ssl application
 proplists:get_value(tls, Options, undefined).
@@ -1182,7 +1217,7 @@ handle_call({_,latest_ctrl_response}, _, #state{latest_ctrl_response=Resp} = Sta
 handle_call({Pid, _}, _, #state{owner = Owner} = State) when Owner =/= Pid ->
 {reply, {error, not_connection_owner}, State};
 
-handle_call({_, {open, ip_comm, Opts}}, From, State) ->
+handle_call({_, {open, ip_comm, Opts, {CtrlOpts, DataPassOpts, DataActOpts}}}, From, State) ->
 ?fcrd("handle_call(open)", [{opts, Opts}]), 
 case key_search(host, Opts, undefined) of
 	undefined ->
@@ -1200,6 +1235,9 @@ handle_call({_, {open, ip_comm, Opts}}, From, State) ->
 				 mode = Mode,
 				 progress = progress(Progress),
 				 ipfamily = IpFamily, 
+ sockopts_ctrl = CtrlOpts,
+ sockopts_data_passive = DataPassOpts,
+ sockopts_data_active = DataActOpts,
 				 dtimeout = DTimeout,
 				 ftp_extension = FtpExt}, 
 
@@ -1218,28 +1256,6 @@ handle_call({_, {open, ip_comm, Opts}}, From, State) ->
 	 end
 end;	
 
-handle_call({_, {open, ip_comm, Host, Opts}}, From, State) ->
- Mode = key_search(mode, Opts, ?DEFAULT_MODE),
- Port = key_search(port, Opts, ?FTP_PORT), 
- Timeout = key_search(timeout, Opts, ?CONNECTION_TIMEOUT),
- DTimeout = key_search(dtimeout, Opts, ?DATA_ACCEPT_TIMEOUT),
- Progress = key_search(progress, Opts, ignore),
- FtpExt = key_search(ftp_extension, Opts, ?FTP_EXT_DEFAULT),
- 
- State2 = State#state{client = From, 
-			 mode = Mode,
-			 progress = progress(Progress), 
-			 dtimeout = DTimeout,
-			 ftp_extension = FtpExt}, 
-
- case setup_ctrl_connection(Host, Port, Timeout, State2) of
-	{ok, State3, WaitTimeout} ->
-	 {noreply, State3, WaitTimeout};
-	{error, _Reason} ->
-	 gen_server:reply(From, {error, ehost}),
-	 {stop, normal, State2#state{client = undefined}}
- end;	
-
 handle_call({_, {open, tls_upgrade, TLSOptions}}, From, State) ->
 send_ctrl_message(State, mk_cmd("AUTH TLS", [])), 
 activate_ctrl_connection(State),
@@ -1822,11 +1838,12 @@ handle_ctrl_result({pos_compl, Lines},
 			 client = From,
 			 caller = {setup_data_connection, Caller},
 			 csock = CSock,
+ sockopts_data_passive = SockOpts,
 			 timeout = Timeout} 
 		 = State) ->
 [_, PortStr | _] = lists:reverse(string:tokens(Lines, "|")),
 {ok, {IP, _}} = peername(CSock),
- case connect(IP, list_to_integer(PortStr), Timeout, State) of
+ case connect(IP, list_to_integer(PortStr), SockOpts, Timeout, State) of
 	{ok, _, Socket} ->	 
 	 handle_caller(State#state{caller = Caller, dsock = {tcp, Socket}});
 	{error, _Reason} = Error ->
@@ -1839,7 +1856,8 @@ handle_ctrl_result({pos_compl, Lines},
 			 ipfamily = inet,
 			 client = From,
 			 caller = {setup_data_connection, Caller},
-			 timeout = Timeout,
+			 timeout = Timeout, 
+ sockopts_data_passive = SockOpts,
 			 ftp_extension = false} = State) ->
 
 {_, [?LEFT_PAREN | Rest]} = 
@@ -1853,7 +1871,7 @@ handle_ctrl_result({pos_compl, Lines},
 Port = (P1 * 256) + P2, 
 
 ?DBG('<--data tcp connect to ~p:~p, Caller=~p~n',[IP,Port,Caller]),
- case connect(IP, Port, Timeout, State) of
+ case connect(IP, Port, SockOpts, Timeout, State) of
 	{ok, _, Socket} ->
 	 handle_caller(State#state{caller = Caller, dsock = {tcp,Socket}});
 	{error, _Reason} = Error ->
@@ -1868,13 +1886,14 @@ handle_ctrl_result({pos_compl, Lines},
 			 caller = {setup_data_connection, Caller},
 			 csock = CSock,
 			 timeout = Timeout,
+ sockopts_data_passive = SockOpts,
 			 ftp_extension = true} = State) ->
 
 [_, PortStr | _] = lists:reverse(string:tokens(Lines, "|")),
 {ok, {IP, _}} = peername(CSock),
 
 ?DBG('<--data tcp connect to ~p:~p, Caller=~p~n',[IP,PortStr,Caller]),
-	case connect(IP, list_to_integer(PortStr), Timeout, State) of
+	case connect(IP, list_to_integer(PortStr), SockOpts, Timeout, State) of
 		{ok, _, Socket} ->	 
 		 handle_caller(State#state{caller = Caller, dsock = {tcp, Socket}});
 		{error, _Reason} = Error ->
@@ -2238,9 +2257,9 @@ handle_caller(#state{caller = {transfer_data, {Cmd, Bin, RemoteFile}}} =
 
 %% Connect to FTP server at Host (default is TCP port 21) 
 %% in order to establish a control connection.
-setup_ctrl_connection(Host, Port, Timeout, State) ->
+setup_ctrl_connection(Host, Port, Timeout, #state{sockopts_ctrl = SockOpts} = State) ->
 MsTime = erlang:monotonic_time(),
- case connect(Host, Port, Timeout, State) of
+ case connect(Host, Port, SockOpts, Timeout, State) of
 	{ok, IpFam, CSock} ->
 	 NewState = State#state{csock = {tcp, CSock}, ipfamily = IpFam},
 	 activate_ctrl_connection(NewState),
@@ -2258,12 +2277,15 @@ setup_ctrl_connection(Host, Port, Timeout, State) ->
 setup_data_connection(#state{mode = active, 
 			 caller = Caller, 
 			 csock = CSock,
+ sockopts_data_active = SockOpts,
 			 ftp_extension = FtpExt} = State) -> 
 case (catch sockname(CSock)) of
-	{ok, {{_, _, _, _, _, _, _, _} = IP, _}} ->
+	{ok, {{_, _, _, _, _, _, _, _} = IP0, _}} ->
+ IP = proplists:get_value(ip, SockOpts, IP0),
 	 {ok, LSock} = 
 		gen_tcp:listen(0, [{ip, IP}, {active, false},
-				 inet6, binary, {packet, 0}]),
+				 inet6, binary, {packet, 0} |
+ lists:keydelete(ip,1,SockOpts)]),
 	 {ok, {_, Port}} = sockname({tcp,LSock}),
 	 IpAddress = inet_parse:ntoa(IP),
 	 Cmd = mk_cmd("EPRT |2|~s|~p|", [IpAddress, Port]),
@@ -2271,9 +2293,11 @@ setup_data_connection(#state{mode = active,
 	 activate_ctrl_connection(State), 
 	 {noreply, State#state{caller = {setup_data_connection, 
 					 {LSock, Caller}}}};
-	{ok, {{_,_,_,_} = IP, _}} ->	 
+	{ok, {{_,_,_,_} = IP0, _}} ->
+ IP = proplists:get_value(ip, SockOpts, IP0),
 	 {ok, LSock} = gen_tcp:listen(0, [{ip, IP}, {active, false},
-					 binary, {packet, 0}]),
+					 binary, {packet, 0} |
+ lists:keydelete(ip,1,SockOpts)]),
 	 {ok, Port} = inet:port(LSock),
 	 case FtpExt of
 	 	false ->
@@ -2312,41 +2336,41 @@ setup_data_connection(#state{mode = passive, ipfamily = inet,
 activate_ctrl_connection(State),
 {noreply, State#state{caller = {setup_data_connection, Caller}}}.
 
-connect(Host, Port, Timeout, #state{ipfamily = inet = IpFam}) ->
- connect2(Host, Port, IpFam, Timeout);
+connect(Host, Port, SockOpts, Timeout, #state{ipfamily = inet = IpFam}) ->
+ connect2(Host, Port, IpFam, SockOpts, Timeout);
 
-connect(Host, Port, Timeout, #state{ipfamily = inet6 = IpFam}) ->
- connect2(Host, Port, IpFam, Timeout);
+connect(Host, Port, SockOpts, Timeout, #state{ipfamily = inet6 = IpFam}) ->
+ connect2(Host, Port, IpFam, SockOpts, Timeout);
 
-connect(Host, Port, Timeout, #state{ipfamily = inet6fb4}) ->
+connect(Host, Port, SockOpts, Timeout, #state{ipfamily = inet6fb4}) ->
 case inet:getaddr(Host, inet6) of
 	{ok, {0, 0, 0, 0, 0, 16#ffff, _, _} = IPv6} ->
 	 case inet:getaddr(Host, inet) of
 		{ok, IPv4} ->
 		 IpFam = inet, 
-		 connect2(IPv4, Port, IpFam, Timeout);
+		 connect2(IPv4, Port, IpFam, SockOpts, Timeout);
 		
 		_ ->
 		 IpFam = inet6, 
-		 connect2(IPv6, Port, IpFam, Timeout)
+		 connect2(IPv6, Port, IpFam, SockOpts, Timeout)
 	 end;
 	
 	{ok, IPv6} ->
 	 IpFam = inet6, 
-	 connect2(IPv6, Port, IpFam, Timeout);
+	 connect2(IPv6, Port, IpFam, SockOpts, Timeout);
 	
 	_ ->
 	 case inet:getaddr(Host, inet) of
 		{ok, IPv4} ->
 		 IpFam = inet,
-		 connect2(IPv4, Port, IpFam, Timeout);
+		 connect2(IPv4, Port, IpFam, SockOpts, Timeout);
 		Error ->
 		 Error
 	 end
 end.
 
-connect2(Host, Port, IpFam, Timeout) ->
- Opts = [IpFam, binary, {packet, 0}, {active, false}], 
+connect2(Host, Port, IpFam, SockOpts, Timeout) ->
+ Opts = [IpFam, binary, {packet, 0}, {active, false} | SockOpts],
 case gen_tcp:connect(Host, Port, Opts, Timeout) of
 	{ok, Sock} ->
 	 {ok, IpFam, Sock};
-- 
2.16.4

Places

File 2598-ftp-Socket-options.patch of Package erlang (Revision 5ba44adc315be86a36b194034819d9be)

Places