
# SID   @(#) tools.txt 1.3 18/07/11 16:25:03

NAME

        O-Saft Tools - tools for  o-saft.pl


DESCRIPTION

        Description of tools around  o-saft.pl,  when, where and how to use.


SYNOPSIS

        o-saft [OPTIONS ..] [COMMANDS ..] target [target target ...]

        o-saft.pl [OPTIONS ..] [COMMANDS ..] target [target target ...]

        o-saft.pl [OPTIONS ..] [COMMANDS ..] target [target target ...] | CMD

        o-saft.tcl [OPTIONS ..] target [target target ...]

        o-saft-docker [OPTIONS ..] [COMMANDS ..] target [target target ...]

        env  QUERY_STRING="--cgi&OPTIONS&COMMANDS&target" o-saft.cgi

        https://o-saft.cgi?--cgi&OPTIONS&COMMANDS&target

        INSTALL.sh

        contrib/install_perl_modules.pl

        contrib/gen_standalone.sh

        contrib/cipher_check.sh

        contrib/critic.sh

        where  [COMMANDS]  and  [OPTIONS]  are described in the corresponding
        documentation of the tool.


CONCEPTS

        The main tool, doing all the SSL/TLS related tests, is  o-saft.pl .
        All other tools described here are just wrappers around  o-saft.pl or
        tools for postprocessing output data of  o-saft.pl .

        These tools can be categorized as follows:

           category       tools            purpose
         #---------------+----------------+----------------------------------
          CLI             o-saft.pl       # it's me
          General Wrapper o-saft          # use o-saft.pl with prostprocessors
          GUI             o-saft.tcl      # use o-saft.pl from GUI
          CGI             o-saft.cgi      # use o-saft.pl from web server
          VM              o-saft-docker   # use o-saft.pl inside docker
          Postprocess     contrib/*       # prostprocessor tools
          Advanced Tools  contrib/*       # use o-saft.pl in advanced modes
          Installation    INSTALL.sh      # simple installation tool
          Development     make            # functional testing
          Development     ....            # ... comming soon
         #---------------+----------------+----------------------------------

        For a description of  o-saft.pl  itself, please see:
          o-saft.pl --help


TOOLS

    CLI
        o-saft.pl  is the main tool, see  CONCEPTS  above.  It will be called
        by all other tools.

    General Wrapper
        o-saft  is the general wrapper.  It calls  o-saft.pl  with all passed
        arguments. All output from called  o-saft.pl  is piped to the command
        specified with the  -post=  option.
        The main purpose is to use postprocessors inside a VM like docker, or
        when called from a CGI script.

          o-saft [COMMANDS] [OPTIONS] target
          o-saft [COMMANDS] [OPTIONS] target -post='bunt.pl'
          o-saft-docker -id=osawp/o-saft -post='bunt.pl' ' [COMMANDS] [OPTIONS] target

    GUI
        o-saft.tcl is the graphical user interface for  o-saft.pl .

          o-saft.tcl
          o-saft.tcl --docker
          o-saft-docker -id=osawp/o-saft

    CGI
        o-saft.cgi is a wrapper to start  o-saft.pl  via a webserver.
        The webpage to use  o-saft.pl  as CGI can be generated with:

          o-saft.pl --no-rc --no-warning --help=gen-cgi

        it cal also be generated using:

          make o-saft.cgi.html

        this HTML form then calls o-saft.cgi with the appropriate parameters.

    VM
        o-saft-docker calls  o-saft.pl  in a docker image.

          o-saft-docker [COMMANDS] [OPTIONS] target
          o-saft-docker -id=osawp/o-saft.pl [COMMANDS] [OPTIONS] target

    Postprocess
        Various postprocessors exist.  They all change the  content or format
        of o-saft.pl's output. See the files itself what they do.

          contrib/bunt.pl
          contrib/*.awk
          contrib/* TBD

    Advanced Tools
        Check a target for ciphers with various methods:

          contrib/cipher_check.sh

        In legacy systems, or when resoources are limited,  a special vesrion
        o-saft-standalone.pl  can be used.  It is a single Perl script, which
        contains most functionality. This script can be generated with:
        
          make o-saft-standalone.pl

    Installation
          INSTALL.sh
          contrib/build_openssl.sh
          contrib/distribution_install.sh
          contrib/install_perl_modules.pl
          contrib/*_completion_o-saft

    Development

        Various, mainly functional, tests have been defined in Makefiles.
        Simply call  make  (without arguments) to get more informations.

          test/.perlcritic
          contrib/critic.sh


CUSTOMIZATION

        The tools can be customized with following files:

        * o-saft.pl
           .o-saft.pl
           o-saft-usr.pl

        * o-saft.tcl
           .o-saft.tcl
           o-saft-img.tcl

        * o-saft.cgi
           none, but see contrib/o-saft.php

        * o-saft-docker
           none, but see o-saft-docker-dev

        * SHELL TWEAKS
           contrib/bash_completion_o-saft
           contrib/dash_completion_o-saft
           contrib/fish_completion_o-saft
           contrib/tcsh_completion_o-saft


SEE ALSO

        * o-saft
        * o-saft.pl
        * o-saft.tcl
        * o-saft-docker
        * o-saft-docker-dev
        * Dockerfile
        * docker
        * INSTALL.sh


VERSION

        @(#) $VERSION

AUTHOR

        18. Jan. 2018 Achim Hoffmann


