From ffba67f2a314cad11737bd7aae54c92b6247ba0b Mon Sep 17 00:00:00 2001 From: niamtokik Date: Mon, 28 Oct 2019 20:31:56 +0000 Subject: [PATCH] original commit --- .gitignore | 19 +++++ LICENSE | 191 ++++++++++++++++++++++++++++++++++++++++++++++ README.md | 23 ++++++ rebar.config | 11 +++ rebar.lock | 1 + src/rekja.app.src | 15 ++++ src/rekja.erl | 90 ++++++++++++++++++++++ src/rekja_app.erl | 26 +++++++ src/rekja_sup.erl | 38 +++++++++ 9 files changed, 414 insertions(+) create mode 100644 .gitignore create mode 100644 LICENSE create mode 100644 README.md create mode 100644 rebar.config create mode 100644 rebar.lock create mode 100644 src/rekja.app.src create mode 100644 src/rekja.erl create mode 100644 src/rekja_app.erl create mode 100644 src/rekja_sup.erl diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..f1c4554 --- /dev/null +++ b/.gitignore @@ -0,0 +1,19 @@ +.rebar3 +_* +.eunit +*.o +*.beam +*.plt +*.swp +*.swo +.erlang.cookie +ebin +log +erl_crash.dump +.rebar +logs +_build +.idea +*.iml +rebar3.crashdump +*~ diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..b5a8089 --- /dev/null +++ b/LICENSE @@ -0,0 +1,191 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + Copyright 2019, Mathieu Kerjouan . + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/README.md b/README.md new file mode 100644 index 0000000..7a536c2 --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# rekja + +Erlang tracer tool around standard Erlang/OTP framework. + +## Build + + $ rebar3 compile + $ rebar3 escriptize + +## Usage + + $ ./_build/default/bin/rekja -node ${remote_node} \ + -cookie ${remote_cookie} + +## Why? + +Distributed Erlang offers great tracing and debugging flexibility +around standard functions. This project was originaly made to solve a +file descriptor leak on a rabbitmq server in production. The idea is +to set a passive node, connect to an active node, and, by using rpc +call ensuring all opened/closed ports are well opened/closed. + +## How? diff --git a/rebar.config b/rebar.config new file mode 100644 index 0000000..e55d76c --- /dev/null +++ b/rebar.config @@ -0,0 +1,11 @@ +{erl_opts, [debug_info]}. +{deps, []}. + +{shell, [ + % {config, "config/sys.config"}, + {apps, [rekja]} +]}. + +{escript_main_app, rekja}. + +{escript_emu_args, "%%! -smp enable -sname rekja\n "}. diff --git a/rebar.lock b/rebar.lock new file mode 100644 index 0000000..57afcca --- /dev/null +++ b/rebar.lock @@ -0,0 +1 @@ +[]. diff --git a/src/rekja.app.src b/src/rekja.app.src new file mode 100644 index 0000000..e433496 --- /dev/null +++ b/src/rekja.app.src @@ -0,0 +1,15 @@ +{application, rekja, + [{description, "An OTP application"}, + {vsn, "0.1.0"}, + {registered, []}, + {mod, {rekja_app, []}}, + {applications, + [kernel, + stdlib + ]}, + {env,[]}, + {modules, []}, + + {licenses, ["Apache 2.0"]}, + {links, []} + ]}. diff --git a/src/rekja.erl b/src/rekja.erl new file mode 100644 index 0000000..7e47dc0 --- /dev/null +++ b/src/rekja.erl @@ -0,0 +1,90 @@ +%%%------------------------------------------------------------------- +%%% +%%%------------------------------------------------------------------- +-module(rekja). +-include_lib("syntax_tools/include/merl.hrl"). +-export([main/1, state/0]). + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +state() -> + #{ cookie => undefined + , node => undefined + }. + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +main(Args) -> + main(Args, state()). + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +main([], State) -> + init(State); +main(["-cookie", Cookie|Rest], State) -> + main(Rest, maps:put(cookie, erlang:list_to_atom(Cookie), State)); +main(["-node", Node|Rest], State) -> + main(Rest, maps:put(node, erlang:list_to_atom(Node), State)); +main(Args, _State) -> + io:format("error, ~p not supported ~n", [Args]). + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +listener_init() -> + io:format("start listener~n"), + erlang:register(listener, self()), + listener_loop(). + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +listener_loop() -> + receive + Msg -> io:format("~p~n", [Msg]), + listener_loop() + end. + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +init(State) -> + _Ets = ets:new(?MODULE, []), + Cookie = maps:get(cookie, State), + Node = maps:get(node, State), + Listener = spawn(fun() -> listener_init() end), + io:format("~p~n", [Listener]), + erlang:set_cookie(erlang:node(), Cookie), + net_kernel:connect_node(Node), + rpc:call(Node, dbg, start, []), + N = node(), + rpc:call(Node, dbg, tracer, [process, { + fun(Message, _) -> + {listener, N} ! Message, + io:format("~p~n", [Message]), 0 + end, 0 + }]), + rpc:call(Node, dbg, p, [all, all]), + loop(). + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +handler(Node) -> + { fun(Message, _) -> + {listener, Node} ! Message, + io:format("~p~n", [Message]), 0 + end, + 0}. + +%%-------------------------------------------------------------------- +%% +%%-------------------------------------------------------------------- +loop() -> + receive + _ -> loop() + end. + diff --git a/src/rekja_app.erl b/src/rekja_app.erl new file mode 100644 index 0000000..ff3f511 --- /dev/null +++ b/src/rekja_app.erl @@ -0,0 +1,26 @@ +%%%------------------------------------------------------------------- +%% @doc rekja public API +%% @end +%%%------------------------------------------------------------------- + +-module(rekja_app). + +-behaviour(application). + +%% Application callbacks +-export([start/2, stop/1]). + +%%==================================================================== +%% API +%%==================================================================== + +start(_StartType, _StartArgs) -> + rekja_sup:start_link(). + +%%-------------------------------------------------------------------- +stop(_State) -> + ok. + +%%==================================================================== +%% Internal functions +%%==================================================================== diff --git a/src/rekja_sup.erl b/src/rekja_sup.erl new file mode 100644 index 0000000..f34dd0f --- /dev/null +++ b/src/rekja_sup.erl @@ -0,0 +1,38 @@ +%%%------------------------------------------------------------------- +%% @doc rekja top level supervisor. +%% @end +%%%------------------------------------------------------------------- + +-module(rekja_sup). + +-behaviour(supervisor). + +%% API +-export([start_link/0]). + +%% Supervisor callbacks +-export([init/1]). + +-define(SERVER, ?MODULE). + +%%==================================================================== +%% API functions +%%==================================================================== + +start_link() -> + supervisor:start_link({local, ?SERVER}, ?MODULE, []). + +%%==================================================================== +%% Supervisor callbacks +%%==================================================================== + +%% Child :: #{id => Id, start => {M, F, A}} +%% Optional keys are restart, shutdown, type, modules. +%% Before OTP 18 tuples must be used to specify a child. e.g. +%% Child :: {Id,StartFunc,Restart,Shutdown,Type,Modules} +init([]) -> + {ok, {{one_for_all, 0, 1}, []}}. + +%%==================================================================== +%% Internal functions +%%====================================================================