SoulSpark
Software
www.skarnet.org

The soulspark program

soulspark is an UCSPI client application that authenticates with a NetSoul server, via a username and a password, then executes another program.

Interface

     soulspark [ -c | -s ] [ -f pwdfile ] user prog...

• soulspark reads a password in pwdfile. If the -f option is not specified, the password is read on fd 3, which is then closed. The password must be given without an ending newline or null character, and must be 512 bytes long at max. It is your responsibility to protect the password.
• soulspark performs NetSoul authentication on the network, sending messages on fd 7 and reading answers on fd 6.
• If the authentication fails, soulspark exits with a message. If the authentication succeeds, it execs prog and its arguments.

Options

• -c : console mode. This is the default. Use this if you're running soulspark on your desktop machine.
• -s : remote mode. Use this if you're remotely logged (or not logged at all) on the machine running soulspark.

Notes

soulspark does not contact the network itself. It should be run under a UCSPI client tool such as tcpclient. The service/soulspark/run file shows an example of tcpclient + soulspark + souldrain combination.