| To build programs, type: |
| $ make |
| Some useful environment variables: |
| CC change C compiler |
| CFLAGS prepend flags to C compiler |
| LDFLAGS prepend flags to linker (e.g. -L <path>) |
| LIBS additional libraries pass to linker |
| SOCKET_LIBS separated socket libraries (e.g. -l socket for SysV) |
| NLS_LIBS libraries for native language support |
| NO_NLS disable native language support |
| To enable to experimental IRC frontend, add '-D ENABLE_IRC_FRONTEND=1' to |
| CFLAGS, for example: |
| $ CFLAGS="-D ENABLE_IRC_FRONTEND=1" make |
| |
| To install built programs and manual pages, type: |
| $ make install |
| Some useful environment variables: |
| PREFIX change installing prefix, default /usr |
| LIBEXECDIR default ${PREFIX}/lib/sshout |
| SBINDIR default ${PREFIX}/sbin |
| DATADIR default ${PREFIX}/share |
| MANDIR default ${DATADIR}/man |
| LOCALEDIR default ${DATADIR}/locale |
| |
| Some additional steps after 'make install' are needed to get this program |
| working: |
| Add a local user account, with name 'sshout' and shell set to the path of |
| installed sshoutd program; there is an example of suitable passwd(5) line: |
| sshout:*:115:115:Secure Shout Host Oriented Unified Talk:/var/lib/sshout:/usr/lib/sshout/sshoutd |
| This user account must be allowed to log in with SSH public key |
| authentication. |
| This program is currently assuming the AuthorizedKeysFile option in |
| sshd_config(5) is left default, or contains '.ssh/authorized_keys'; otherwise |
| the authentication won't work. |
| Create a service so sshoutd can be started automatically; the service must be |
| started under the sshout user, instead of root. For systemd based systems, |
| you can use the systemd service file provided in 'deploy' directory, by running: |
| # cp deploy/systemd/sshout.service /etc/systemd/system/ |
| And of course you need a working SSH server installed; currently only OpenSSH |
| server is supported. |
| |
| The CLI frontend requiring some addional programs for some features to work: |
| '/pasteimage <user>' requires xclip(1) be available in PATH; |
| '/showhtml color|plain' requires elinks(1) version 0.12 or later be available |
| in PATH. |