github.com/cloud-foundations/dominator@v0.0.0-20221004181915-6e4fee580046/cmd/filegen-client/README.md (about)

     1  # filegen-client
     2  A utility to test and benchmark a
     3  *[filegen-server](../filegen-server/README.md)*.
     4  
     5  The *filegen-client* utility may be used to send queries to a running
     6  *filegen-server* in order to debug or benchmark the server.
     7  
     8  ## Usage
     9  *Filegen-client* will get per-machine file data for a specified pathname from
    10  the specified *filegen-server*. The data for each machine are written to stdout.
    11  The basic usage pattern is:
    12  
    13  ```
    14  filegen-client [flags...] pathname source
    15  ```
    16  
    17  Built-in help is available with the command:
    18  
    19  ```
    20  filegen-client -h
    21  ```
    22  
    23  The `-mdbFile` option specifies the file to read MDB data from. If this file
    24  changes then it is re-read and if the MDB data for any machine changes, new file
    25  contents will be generated and displayed.
    26  
    27  ## Security
    28  *[Filegen-server](../filegen-server/README.md)* restricts RPC access using TLS
    29  client authentication. *Filegen-client* will load certificate and key files from
    30  the `~/.ssl` directory. *Filegen-client* will present these certificates to
    31  *filegen-server*. If one of the certificates is signed by a certificate
    32  authority that *filegen-server* trusts, *filegen-server* will grant access.