Add man pages for the scripts this package provides.

20 files changed, 271 insertions, 3 deletions

diff --git a/debian/copyright b/debian/copyright
index 4398b65..6f6378e 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -142,7 +142,16 @@ Files: bin/smarttech-SMARTBoardService
  examples/disklserver/tftp/x2go-tce/debian-edu/default-menu.cfg
  examples/disklserver/README.tftp
  lib-udev-rules.d/60-SMARTBoard32.rules
- man/diskless-workstation-shell.8
+ man/diskless-workstation-shell*.8
+ man/e2guardian-update-shallalists.8
+ man/itzks-display-shell.8
+ man/itzks-goodbye-user-session.1
+ man/itzks-hosts.1
+ man/itzks-systems.do_preseed.8
+ man/itzks-transfer-cleaner.8
+ man/itzks-transfer-create.8
+ man/itzks-update-disklserver-squashfs-images.8
+ man/smarttech-SMARTBoardService.1
  README.backup
  README.diskless
  README.disklserver
diff --git a/debian/itzks-systems-common.manpages b/debian/itzks-systems-common.manpages
new file mode 100644
index 0000000..c02d707
--- /dev/null
+++ b/debian/itzks-systems-common.manpages
@@ -0,0 +1 @@
+man/itzks-systems.do_preseed.8
diff --git a/debian/itzks-systems-diskless.manpages b/debian/itzks-systems-diskless.manpages
new file mode 100644
index 0000000..85a5214
--- /dev/null
+++ b/debian/itzks-systems-diskless.manpages
@@ -0,0 +1,2 @@
+man/itzks-hosts.1
+man/itzks-goodbye-user-session.1
\ No newline at end of file
diff --git a/debian/itzks-systems-disklserver.manpages b/debian/itzks-systems-disklserver.manpages
index 1c5352c..edc5172 100644
--- a/debian/itzks-systems-disklserver.manpages
+++ b/debian/itzks-systems-disklserver.manpages
@@ -1 +1,2 @@
 man/diskless-workstation-shell*.8
+man/itzks-update-disklserver-squashfs-images.8
\ No newline at end of file
diff --git a/debian/itzks-systems-displayserver.manpages b/debian/itzks-systems-displayserver.manpages
index e52f2e4..4212af2 100644
--- a/debian/itzks-systems-displayserver.manpages
+++ b/debian/itzks-systems-displayserver.manpages
@@ -1 +1 @@
-man/diskless-workstation-shell.8
+man/itzks-display-shell.8
diff --git a/debian/itzks-systems-filter.manpages b/debian/itzks-systems-filter.manpages
new file mode 100644
index 0000000..5840249
--- /dev/null
+++ b/debian/itzks-systems-filter.manpages
@@ -0,0 +1 @@
+man/e2guardian-update-shallalists.8
\ No newline at end of file
diff --git a/debian/itzks-systems-mainserver.manpages b/debian/itzks-systems-mainserver.manpages
new file mode 100644
index 0000000..c3692ec
--- /dev/null
+++ b/debian/itzks-systems-mainserver.manpages
@@ -0,0 +1,3 @@
+man/itzks-hosts.1
+man/itzks-transfer-create.8
+man/itzks-transfer-cleaner.8
diff --git a/debian/itzks-systems-smartboard.manpages b/debian/itzks-systems-smartboard.manpages
new file mode 100644
index 0000000..a7a199e
--- /dev/null
+++ b/debian/itzks-systems-smartboard.manpages
@@ -0,0 +1,2 @@
+man/smarttech-SMARTBoardService.1
+
diff --git a/debian/itzks-systems-terminalserver.manpages b/debian/itzks-systems-terminalserver.manpages
new file mode 100644
index 0000000..e4694fe
--- /dev/null
+++ b/debian/itzks-systems-terminalserver.manpages
@@ -0,0 +1 @@
+man/itzks-goodbye-user-session.1
\ No newline at end of file
diff --git a/debian/itzks-systems-workstation.manpages b/debian/itzks-systems-workstation.manpages
new file mode 100644
index 0000000..85a5214
--- /dev/null
+++ b/debian/itzks-systems-workstation.manpages
@@ -0,0 +1,2 @@
+man/itzks-hosts.1
+man/itzks-goodbye-user-session.1
\ No newline at end of file
diff --git a/man/diskless-workstation-shell.8 b/man/diskless-workstation-shell.8
index 5a22c8d..c986220 100644
--- a/man/diskless-workstation-shell.8
+++ b/man/diskless-workstation-shell.8
@@ -5,7 +5,7 @@
 \\$2 \(la\\$1\(ra\\$3
 ..
 .if \n(.g .mso www.tmac
-.TH diskless-workstation-shell 8 "March 2019" "Version 0.3" "IT-Zukunft Schule"
+.TH diskless-workstation-shell 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
 .SH NAME
 diskless-workstation-shell \- Opens a shell within the ITZkS Diskless Workstation Chroot (Debian stable chroot)
 .SH SYNOPSIS
diff --git a/man/e2guardian-update-shallalists.8 b/man/e2guardian-update-shallalists.8
new file mode 100644
index 0000000..8b45097
--- /dev/null
+++ b/man/e2guardian-update-shallalists.8
@@ -0,0 +1,33 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH e2guardian-update-shalllists 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+e2guardian-update-shalllists \- Update content filter blacklists provided by Shalla Secure Services KG
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B e2guardian-update-shalllists
+
+.SH DESCRIPTION
+This script is to be installed as a CRON job. It can be used to regularly
+install/update URL blacklists provided by Shalla Secure Services KG.
+.PP
+The blacklists will be downloaded and installed to /var/lib/e2guardian/blacklists.
+.PP
+To make these lists available to e2guardian, make sure to include those
+list via /etc/e2guardian/lists/bannedurllist and
+/etc/e2guardian/lists/bannedsitelist.
+.PP
+.SH OPTIONS
+\fBe2guardian-update-shalllists\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
+
diff --git a/man/itzks-display-shell.8 b/man/itzks-display-shell.8
new file mode 100644
index 0000000..f713296
--- /dev/null
+++ b/man/itzks-display-shell.8
@@ -0,0 +1,27 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-display-shell 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-display-shell \- Opens a shell within the ITZkS Display System Chroot
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-display-shell
+
+.SH DESCRIPTION
+This helper script opens a shell within the ITZkS Display System chroot environment.
+.PP
+\fBNOTE:\fR Use this script to perform maintenance work within your ITZkS Display System chroot.
+.PP
+.SH OPTIONS
+\fBitzks-display-shell\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/itzks-goodbye-user-session.1 b/man/itzks-goodbye-user-session.1
new file mode 100644
index 0000000..38cf857
--- /dev/null
+++ b/man/itzks-goodbye-user-session.1
@@ -0,0 +1,27 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-goodbye-user-session 1 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-goodbye-user-session \- Forcefully logout a user from a system
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-goodbye-user-session
+
+.SH DESCRIPTION
+This script can be used e.g. from within a screensaver dialog to kill the underlying user session and get back
+to the system's login manager. Such a screensaver feature can be very helpful if people forget to logout their
+sessions and clutter the workstation with open applications, etc.
+.PP
+.SH OPTIONS
+\fBitzks-goodbye-user-session\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/itzks-hosts.1 b/man/itzks-hosts.1
new file mode 100644
index 0000000..9ded5e3
--- /dev/null
+++ b/man/itzks-hosts.1
@@ -0,0 +1,26 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-hosts 1 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-hosts \- Print LDAP hosts to stdout in CSV file format
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-hosts
+
+.SH DESCRIPTION
+This little script prints a list of all school computers managed in LDAP to stdout. The printout is in
+CSV file format and, if needed, can be further processed in your favourite spreadsheet tool.
+.PP
+.SH OPTIONS
+\fBitzks-hosts\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/itzks-systems.do_preseed.8 b/man/itzks-systems.do_preseed.8
new file mode 100644
index 0000000..b6237e1
--- /dev/null
+++ b/man/itzks-systems.do_preseed.8
@@ -0,0 +1,28 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-systems.do_preseed 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-systems.do_preseed \- Pre-configure DEB packages to be installed on ITZkS systems.
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-systems.do_preseed
+
+.SH DESCRIPTION
+This script pre-seeds some DEB packages that are already or are to be installed on this system.
+.PP
+See the code of the script to understand what will happen, if you execute it.
+.PP
+.SH OPTIONS
+\fBitzks-systems.do_preseed\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
+
diff --git a/man/itzks-transfer-cleaner.8 b/man/itzks-transfer-cleaner.8
new file mode 100644
index 0000000..1474d0d
--- /dev/null
+++ b/man/itzks-transfer-cleaner.8
@@ -0,0 +1,27 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-transfer-cleaner 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-transfer-cleaner \- Keep /skole/<server>/transfer area clean over time
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-transfer-cleaner
+
+.SH DESCRIPTION
+This script removes old files from the transfer area on the fileserver. It normally runs as a CRON job.
+
+Don't use it manually, unless you know what you are doing.
+.PP
+.SH OPTIONS
+\fBitzks-transfer-cleaner\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/itzks-transfer-create.8 b/man/itzks-transfer-create.8
new file mode 100644
index 0000000..00150c4
--- /dev/null
+++ b/man/itzks-transfer-create.8
@@ -0,0 +1,25 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-transfer-create 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-transfer-create \- Create /skole/<server>/transfer area for file exchange
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-transfer-create
+
+.SH DESCRIPTION
+This script creates an area dedicated to inter-user file exchange. Don't use it, unless you know what you are doing.
+.PP
+.SH OPTIONS
+\fBitzks-transfer-create\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/itzks-update-disklserver-squashfs-images.8 b/man/itzks-update-disklserver-squashfs-images.8
new file mode 100644
index 0000000..bc27dbd
--- /dev/null
+++ b/man/itzks-update-disklserver-squashfs-images.8
@@ -0,0 +1,28 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH itzks-update-disklserver-squashfs-images 8 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+itzks-update-disklserver-squashfs-images \- Generate SquashFS image of DLW chroot (if needed, if configured)
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B itzks-update-disklserver-squashfs-images
+
+.SH DESCRIPTION
+This script gets nightly run on diskless chroot image servers via CRON. If a new DLW chroot has been deployed
+to this system (from the central ITZkS DLW chroot server), this script will rebuild the DLW chroot's SquashFS image.
+.PP
+Diskless workstations using SquashFS images (via NBD server) are 5-8 times faster than those running via NFS servers.
+.PP
+.SH OPTIONS
+\fBitzks-update-disklserver-squashfs-images\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).
diff --git a/man/smarttech-SMARTBoardService.1 b/man/smarttech-SMARTBoardService.1
new file mode 100644
index 0000000..2d8f6a5
--- /dev/null
+++ b/man/smarttech-SMARTBoardService.1
@@ -0,0 +1,25 @@
+'\" -*- coding: utf-8 -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH smarttech-SMARTBoardService 1 "April 2019" "Version 2019.04.04.1" "IT-Zukunft Schule"
+.SH NAME
+smarttech-SMARTBoardService \- Wrapper script to launch chrooted SMART Board Service
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+.B smarttech-SMARTBoardService
+
+.SH DESCRIPTION
+A wrapper script around SMART Board Service shipped with our proprietary Ubuntu precise chroot with SMART Notebook installed inside.
+.PP
+.SH OPTIONS
+\fBsmarttech-SMARTBoardService\fR has no known options.
+.PP
+.SH AUTHOR
+This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the IT-Zukunft Schule project
+(http://wiki.it-zukunft-schule.de).