From d446bbdb5144913ad6d62fada37263f68c315a62 Mon Sep 17 00:00:00 2001 From: QU35T-code Date: Sun, 20 Oct 2024 12:24:04 +0200 Subject: [PATCH 1/2] Add asdf tip --- source/getting-started/tips-and-tricks.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/source/getting-started/tips-and-tricks.rst b/source/getting-started/tips-and-tricks.rst index 08cf606..fad5ffb 100644 --- a/source/getting-started/tips-and-tricks.rst +++ b/source/getting-started/tips-and-tricks.rst @@ -54,6 +54,21 @@ The best reverse shells * simple alternative way to have an upgrade netcat reverse shell: use ``rlwrap `` * instead of using ``netcat`` and "upgrade" the shell manually, ``pwncat-cs`` (`calebstewart/pwncat `_) can be used to obtain an even better reverse shell experience (especially with UNIX-like targets). +Installing new tools ? +~~~~~~~~~~~~~~~~~~~~~~~ + +To manage tool versions, we use ``asdf`` (`asdf-vm/asdf `_), a version management tool that allows the installation and management of multiple versions of various programming languages and tools across different projects. ``asdf`` uses a system of shims to ensure that the correct version of a tool is used based on your project's configuration. + +Currently, on Exegol, asdf only manages the ``Go`` programming language (``golang``). If you choose to install a new golang tool in your container using the ``go install ...`` command, you will need to follow it up with the ``asdf reshim golang`` command. This additional step is necessary for asdf to recognize and integrate the newly installed tool into the environment. + +Here is an example of usage : + +.. code-block:: bash + + go install -v github.com/patrickhener/goshs@latest + asdf reshim golang + goshs --help + Keyboard shortcuts ~~~~~~~~~~~~~~~~~~ From d1b43600934ffc4c2c52ccca172c7e83e8ed63b0 Mon Sep 17 00:00:00 2001 From: QU35T-code Date: Sun, 20 Oct 2024 12:40:25 +0200 Subject: [PATCH 2/2] Move text to contributor section --- source/community/contributors.rst | 11 ++++++++++- source/getting-started/tips-and-tricks.rst | 15 --------------- 2 files changed, 10 insertions(+), 16 deletions(-) diff --git a/source/community/contributors.rst b/source/community/contributors.rst index 3acef23..20a1854 100644 --- a/source/community/contributors.rst +++ b/source/community/contributors.rst @@ -106,6 +106,9 @@ When installing a tool, depending on how it gets installed, here are the rules. * Most tools are installed either in their own directory in ``/opt/tools/`` or have the binary (or a symlink) in ``/opt/tools/bin/``. * Disk space being limited, we're not pulling every code source around. When possible, add the ``--depth 1`` option to your usual ``git clone`` command. +To manage tool versions, we use ``asdf`` (`asdf-vm/asdf `_), a version management tool that allows the installation and management of multiple versions of various programming languages and tools across different projects. ``asdf`` uses a system of shims to ensure that the correct version of a tool is used based on your project's configuration. Currently, on Exegol, asdf only manages the ``Go`` programming language (``golang``). + + .. tabs:: .. tab:: Python sources (pipx) @@ -153,8 +156,14 @@ When installing a tool, depending on how it gets installed, here are the rules. The package you want to install needs to be added there, along with the ``add-history``, ``add-test-command`` and ``add-to-list`` instructions. .. tab:: Go + If you choose to install a new golang tool in your container using the ``go install -v github.com/AUTHOR/REPO@latest`` command, you will need to follow it up with the ``asdf reshim golang`` command. This additional step is necessary for asdf to recognize and integrate the newly installed tool into the environment. + + .. code-block:: bash + + go install -v github.com/patrickhener/goshs@latest + asdf reshim golang + goshs --help - Go tools can be installed with a standard ``go install -v github.com/AUTHOR/REPO@latest`` command. .. tab:: Ruby diff --git a/source/getting-started/tips-and-tricks.rst b/source/getting-started/tips-and-tricks.rst index fad5ffb..08cf606 100644 --- a/source/getting-started/tips-and-tricks.rst +++ b/source/getting-started/tips-and-tricks.rst @@ -54,21 +54,6 @@ The best reverse shells * simple alternative way to have an upgrade netcat reverse shell: use ``rlwrap `` * instead of using ``netcat`` and "upgrade" the shell manually, ``pwncat-cs`` (`calebstewart/pwncat `_) can be used to obtain an even better reverse shell experience (especially with UNIX-like targets). -Installing new tools ? -~~~~~~~~~~~~~~~~~~~~~~~ - -To manage tool versions, we use ``asdf`` (`asdf-vm/asdf `_), a version management tool that allows the installation and management of multiple versions of various programming languages and tools across different projects. ``asdf`` uses a system of shims to ensure that the correct version of a tool is used based on your project's configuration. - -Currently, on Exegol, asdf only manages the ``Go`` programming language (``golang``). If you choose to install a new golang tool in your container using the ``go install ...`` command, you will need to follow it up with the ``asdf reshim golang`` command. This additional step is necessary for asdf to recognize and integrate the newly installed tool into the environment. - -Here is an example of usage : - -.. code-block:: bash - - go install -v github.com/patrickhener/goshs@latest - asdf reshim golang - goshs --help - Keyboard shortcuts ~~~~~~~~~~~~~~~~~~