clone/update: mark project changed on failure
[girocco.git] / screen / README
blob070e10c2e9bde71139c730b74706ee6600ddbb37
1 The files in this directory are for use with screen.
3 If using the ../cron/girocco cron setup to run the jobd and taskd,
4 then the screenrc file in this directory should be installed as
5 $HOME/.screenrc in order for the ../cron/girocco cron file to work
6 properly.  (The $HOME directory here is that of the Config.pm
7 mirror_user.)
9 The screenrc file in this directory should not need to be modified.
11 The girocco file in this directory is used by the ../cron/girocco
12 cron file as-is and should not need to be modified.
14 The giroccoacl file in this directory adds multiuser screen access
15 and should be modified to add the desired users to the multiuser
16 screen that runs jobd and taskd.  To use an alternate giroccoacl
17 file instead, simply copy the giroccoacl file somewhere else, modify
18 it and then set the Config.pm $screen_acl_file setting to the new
19 location.
21 Note that in order to make screen multiuser capable, these commands
22 need to be run:
24   sudo chmod u+s /usr/bin/screen
25   sudo chmod g-w /var/run/screen
27 In addition, on a deb pkg machine an override should be added like so:
29   sudo dpkg-statoverride --add root utmp 6755 /usr/bin/screen
31 Furthermore, if both the screen and systemd packages are active at the
32 same time then you will likely need to add a /etc/tmpfiles.d/screen-cleanup.conf
33 file to override the /usr/lib/tmpfiles.d/screen-cleanup.conf like so:
35   # without this a u+s multiuser /usr/bin/screen will not run after a reboot
36   # (or package upgrade) when both the screen and systemd packages are active
37   sudo sh -c "sed -e 's/0775/0755/' </usr/lib/tmpfiles.d/screen-cleanup.conf \
38     >/etc/tmpfiles.d/screen-cleanup.conf"
40 Otherwise /var/run/screen will end up with the wrong permissions after the
41 next reboot (or package upgrade) and screen will refuse to run.