From aa26be6cc0d7999947cc13ef5e5531f0d29baf5d Mon Sep 17 00:00:00 2001 From: sthen Date: Tue, 26 Feb 2019 11:54:57 +0000 Subject: [PATCH] Tweak DESCR to make it a bit clearer what the -net flavour of comms/conserver is for. (It's only needed when you have conserver(8) and console(1) on different machines, or when you have conserver(8) on multiple machines clustered behind a single front-end). --- comms/conserver/Makefile | 4 ++-- comms/conserver/pkg/DESCR | 30 +++++++++++++++++------------- 2 files changed, 19 insertions(+), 15 deletions(-) diff --git a/comms/conserver/Makefile b/comms/conserver/Makefile index 7d92b1c7ec3..c15df9b2030 100644 --- a/comms/conserver/Makefile +++ b/comms/conserver/Makefile @@ -1,9 +1,9 @@ -# $OpenBSD: Makefile,v 1.65 2019/02/25 19:53:16 sthen Exp $ +# $OpenBSD: Makefile,v 1.66 2019/02/26 11:54:57 sthen Exp $ COMMENT= manage remote serial consoles via TCP/IP V= 8.2.2 -REVISION= 3 +REVISION= 4 DISTNAME= conserver-$V CATEGORIES= comms diff --git a/comms/conserver/pkg/DESCR b/comms/conserver/pkg/DESCR index 8bf0fe80f00..7f78d2358db 100644 --- a/comms/conserver/pkg/DESCR +++ b/comms/conserver/pkg/DESCR @@ -1,19 +1,23 @@ -This program provides a convenient way to manage many remote serial -consoles for machines. A server (conserver(1)) runs on each server -machine and it connects to the specified serial port. It can log, -provide shared access to remote consoles, etc. If there are multiple -machines running conserver(1), a master conserver(1) can be run to -connect to all the slave servers, providing a single point of access -to the entire cluster. +This program provides a convenient way to manage remote consoles. -This is very handy for remote unattended OpenBSD servers. It can -send serial break signals (if the driver supports it, cy(4) does not!) -which is useful for breaking into DDB on hung machines. +The conserver(8) daemon maintains persistent connections to consoles, +either to a local serial port, via a network connection to a terminal +server, via a UNIX domain socket, by running a command, or (with the +"ipmi" flavor) via IPMI serial-over-lan. It can also write logfiles, +and restrict access based on user/group (read, read/write, none). + +User access is done with console(1) - this allows standard terminal +commands including sending BREAK signals, and can replay output from +before you connected. + +By default conserver<>console connections are done via a unix-domain +socket, but in a larger installation, the "net" flavor can be used +to do this over a TCP+TLS connection to another host - in that case, +conserver(8) instances on multiple servers can be clustered. Flavors: -net - use network sockets rather than unix domain sockets -(as was previously the default). This is mainly useful when -the conserver server is on a separate machine to the client. +net - use network sockets for conserver<>console and to allow +conserver<>conserver connections. ipmi - build with internal support for IPMI serial-over-lan