/usr/share/doc/cereal/example-cereal-setup.txt is in cereal 0.24-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | Using Cereal for simple serial console access
---------------------------------------------
Here is a common way to set up cereal.
The assumption here is that the second serial port on one machine
(galago) is connected to the serial console of another host (douc).
## begin by creating on galago a group which can view the logs from douc, but
## can't necessarily attach to douc's serial console:
0 galago:~# addgroup doucviewers
Adding group `doucviewers' (GID 1001) ...
Done.
## create a separate user account who will control douc (and can attach):
0 galago:~# adduser --ingroup doucviewers --disabled-password --gecos 'douc console controller,,,' doucconsole
Adding user `doucconsole' ...
Adding new user `doucconsole' (1001) with group `doucviewers' ...
Creating home directory `/home/doucconsole' ...
Copying files from `/etc/skel' ...
## set up access for that user with ssh keys (here we just use the
## same keypairs that can already connect to root):
0 galago:~# cat ~/.ssh/authorized_keys >> ~doucconsole/.ssh/authorized_keys
## set up the cereal session itself:
0 galago:~# cereal-admin create douc /dev/ttyS1 115200 doucconsole doucviewers
Created session 'douc'.
0 galago:~# cereal-admin list douc
--f douc /dev/ttyS1 115200 doucconsole doucviewers
0 galago:~# cereal-admin enable douc
Enabled session 'douc'.
0 galago:~# cereal-admin list douc
+-f douc /dev/ttyS1 115200 doucconsole doucviewers
0 galago:~#
|