procserv介绍

参考地址：procserv(1) - Linux man page (die.net)

名称

procServ：带Telnet console和日志访问的进程服务程序。

简介

procServ [OPTIONS] port command args ...

描述

procServ为一条命令(例如，一个软IOC)创建一个运行时环境。它分叉出一个作为进入后台的守护运行的服务程序，这创建一个子进行，它用来自命令行所有剩下args运行命令。这个服务程序通过在指定端口提供telnet连接为子进程提供console访问(stdin/stdout)。出于安全原因，默认访问被限制于来自本地(127.0.0.1)的连接，因而需要登录到主机上一个有效账户。

可以使用-L(--logfile)选项配置procServ写子进程所有输入和输出的console日志到一个文件。发送一个信号SIGHUP到这个服务器程序将使其重新打开这个日志文件。为了便于运行在一个中心console访问管理(如conserver)，-l(--logport)选项再创建一个telnet端口，它默认是公共的(例如，被受限于localhost)，并且提供对这个子进程console的只读日志访问。-r(--restrict)选项限制日志端口为本地，类似于访问端口。

访问和日志端口允许多个连接，它们被透明地处理：来自访问连接的所有输入被转发给这个子进程，来自这个子进程的所有输出被转发给所有访问和日志连接(并且被写入日志文件)。来自这个服务进程的所有诊断消息以"@@@"开头，明确地区别于来自子进程消息。为了提高可读性，一个由-n(--name)选项指定的名称将替换很多消息中的命令字符串。

当子进程终止时，服务程序默认自动再生产这个子进程。为了避免旋转，子进程重启之间最短时长需要保证(默认，15秒，可以使用-holdoff选项更改它)。使用转换命令^T，可以在线转换这种行为，使用--noautorestart选项可以更改默认。通过使用kill命令^X发送一个信号给子进程，你可以手动地重启一个正在运行地子进程。对于子进程被关闭了，服务程序接受两个命令：^R或^X重启这个子进程，和^Q退出服务程序。-w(--wait)选项选项启动在关闭模式中地服务程序，等待一个telnet连接来发送手动启动命令来创建子进程。

使用客户端的断开顺序，可以断开任何telnet连接(控制或日志)。通过发送登出命令字符，也可以断开控制连接，可以使用-x(--logoutcmd)选项指定那个字符。

要阻塞对子进程潜在危险的输入字符(例如，作用域软IOCs的^D和^C)，可以使用-i(--ignore)选项指定在来自一个console访问端口时悄悄被忽略的字符。

为了便于作为标准系统服务被启动和停止，-p(--pidfile)选项告诉服务程序创建一个包含这个服务程序进程PID的标准PID文件。

-d(--debug)选项在调试模式运行服务程序：这个守护进程留在前台，打印所有正常日志内容和其它调试消息到stdout。

选项

1）--allow：允许来自任何地方的控制连接。(默认：限制控制访问于localhost)。如果子进程允许，创建了一个严重安全漏洞，由于来自任何地方的telnet客户端可以连接到子进程的stdin/stdout并且执行主机上任何命令。需要在编译时被使能(见Makefile)。除非你确切地知道你为什么正在做和你正在做什么，否则请不要使能和使用这个选项。

2）--autorestartcmd=char：切换当在访问连接上发送char时自动重启标志。使用^指定控制字符，""禁用。默认^T。

3) --coresize=size：设置core文件地最大尺寸。详见getrlimit文档。设置size为0将避免子进程创建core文件。

4）-c, --chdir=dir：在启动子进程前，切换dir的目录为dir。在子进程每次启动时，做这件事，确保在子进程重启时符号链接被解析。

5) -d, --debug：进入调试模式。调试模式将保持服务进程在前台，并且使能诊断消息将被发送给控制终端。

6) -e, --exec=file：为子进程以可执行文件运行file。默认时command。

7) -f, --foreground：保持服务进程在前台并且连接到控制终端。

8) -h, --help：打印帮助消息。

9) --holdoff=n：在子进程重启尝试之际爱你等待至少n秒。默认是15秒。

10) -i, --ignore=chars：忽略访问连接上再chars中所有字符。这可以用于子进程屏蔽来自潜在危险的输入字符，例如，关闭软IOC的^D和^C。使用^指定控制字符，^^指定单个^字符。

11) -k, --killcmd=char：当在一个访问连接上发送char时，杀死这个子进程(默认自动重启子进程)。使用^指定一个控制字符，""用于没有杀死命令。默认是^X。

12) --killsig=signal：当接受到这个kill命令时，使用signal杀死子进程。默认是9(SIGKILL)。

13) -l, --logport=port：在port上提供对子进程console的只读访问。默认，所有主机可以连接port，使用-r(--restrict)选项限制访问于localhost。

14) -L, --logfile=file：写一个所有输入和输出的console日志到file。

15) --logstamp[=fmt]：在日志中带时间戳的前缀行，设置时间戳格式字符串为fmt。默认是"[<timefmt>]"。(见--timefmt)选项。)

16) -n, --name=tile：在所有服务程序消息中，使用title替代完整命令行来增加可读性。

17) --noautorestart：退出时不要自动重启子进程。

18) -p, --pidfile=file：写服务进程的PID到file以便于集成到常规的系统服务管理机制中。

19）--timefmt=fmt：设置用于打印时间戳的格式字符串为fmt。默认是"%c"。(详见strftime)。

20) -q, --quiet：不要写信息输出(服务程序)。当作为系统脚本的一部分运行时，避免弄乱屏幕。

21) --restrict：限制日志连接于localhost。

22) -V, --version：打印程序版本。

23) -w , --wait：不要立即立即启动子进程。而是，等待telnet连接和手动启动命令。

24) -x, --logoutcmd=char：当在访问连接上发送char时，登出(关闭客户端连接)。使用哦个^指定控制字符。莫瑞诺是空。

用法

要使用procServ启动一个软IOC，更换到IOC的启动目录。一个代表性命令行是：

procServ -n "My SoftIOC" -i ^D^C 20000 ./st.cmd

要连接这个IOC，登录到这个软IOC的主机并且使用以下连接端口20000：

telnet localhost 20000

要从一个远程机器连接，ssh到procserhost上一个用户账号并且连接到端口20000：

ssh -t user@procservhost telnet localhost 20000

 你将连接到这个软IOCs console并且接收到一条信息欢迎消息。来自procServ服务器的所有输出将以"@@@"开头，使得能够区分来自你IOC发送的消息。

> telnet localhost 20000 Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. @@@ Welcome to the procServ process server (procServ Version 2.1.0) @@@ Use ^X to kill the child, auto restart is ON, use ^T to toggle auto restart @@@ procServ server PID: 21413 @@@ Startup directory: /projects/ctl/lange/epics/ioc/test314/iocBoot/iocexample @@@ Child "My SoftIOC" started as: ./st.cmd @@@ Child "My SoftIOC" PID: 21414 @@@ procServ server started at: Fri Apr 25 16:43:00 2008 @@@ Child "My SoftIOC" started at: Fri Apr 25 16:43:00 2008 @@@ 0 user(s) and 0 logger(s) connected (plus you)

输入杀死命令字符^X来重启这个软IOC，并且获取有关这个操作的服务程序消息。

输入telnet转义字符^]退回到一个telnet提示符，接着"quit"退出telnet(和ssh，当你正在远程连接时)。

虽然procServ原来是为了成为一个运行软IOCs的环境，但任何进程可以作为子进程被启动。它为需要访问其console的任何程序提供环境，在后台作为一个守护运行，并且通过写一个文件或者通过console访问和日志工具(诸如conserver)维护一个日志。

环境变量

PROCSERV_PID：设置写服务进程的PID所到的文件名。(见-p选项)。

PROCSERV_DEBUG：如果设置，procServ以调试模式启动(见-d选项)。

示例

在Ubuntu 22.04上，安装所需软件包：

apt-get install asciidoc apt-get install libtelnet-dev apt-get install telnet apt-get install procserv 

 创建一个简单的IOC应用程序，来进行测试：

数据库文件如下：

root@orangepi5:/usr/local/EPICS/program/softIoc# cat db/simpledb.vdb record(waveform, "$(USER):wfin") {   field(DESC, "A Example Waveform")   field(SCAN, "Passive")   field(NELM, "10")   field(FTVL, "LONG") }  record(stringin, "$(USER):StrIn") {   field(DESC, "A Example StringIn")   field(SCAN, "Passive")   field(VAL, "HelloWorld")   field(PINI, "YES") }

启动文件脚本如下：

#!../../bin/linux-aarch64/softIoc  #- You may have to change softIoc to something else #- everywhere it appears in this file  < envPaths  cd "${TOP}"  ## Register all support components dbLoadDatabase "dbd/softIoc.dbd" softIoc_registerRecordDeviceDriver pdbbase  ## Load record instances dbLoadRecords("db/simpledb.vdb","USER=TEST")  cd "${TOP}/iocBoot/${IOC}" iocInit

进入IOC的启动目录softIoc/iocBoot/iocsoftIoc执行以下命令：

root@orangepi5:/usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc#  procServ -n "My SoftIOC" -i ^D^C 20000 ./st.cmd procServ: spawning daemon process: 147476 Warning: No log file and no port for log connections specified. 

用本地telnet客户端进行连接：

root@orangepi5:/usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc# telnet localhost 20000 Trying ::1... Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. @@@ Welcome to procServ (procServ Process Server 2.7.0) @@@ Use ^X to kill the child, auto restart is ON, use ^T to toggle auto restart @@@ procServ server PID: 147476 @@@ Server startup directory: /usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc @@@ Child startup directory: /usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc @@@ Child "My SoftIOC" started as: ./st.cmd @@@ Child "My SoftIOC" PID: 147477 @@@ procServ server started at: Thu Jul  4 20:38:30 2024 @@@ Child "My SoftIOC" started at: Thu Jul  4 20:38:30 2024 @@@ 0 user(s) and 0 logger(s) connected (plus you) 

用远程主机进行访问：

(base) [blctrl@localhost ~]$ ssh -t orangepi@192.168.50.184 telnet localhost 20000 orangepi@192.168.50.184's password: Trying ::1... Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. @@@ Welcome to procServ (procServ Process Server 2.7.0) @@@ Use ^X to kill the child, auto restart is ON, use ^T to toggle auto restart @@@ procServ server PID: 147476 @@@ Server startup directory: /usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc @@@ Child startup directory: /usr/local/EPICS/program/softIoc/iocBoot/iocsoftIoc @@@ Child "My SoftIOC" started as: ./st.cmd @@@ Child "My SoftIOC" PID: 147477 @@@ procServ server started at: Thu Jul  4 20:38:30 2024 @@@ Child "My SoftIOC" started at: Thu Jul  4 20:38:30 2024 @@@ 1 user(s) and 0 logger(s) connected (plus you) 

通道访问测试：

root@orangepi5:~# caget TEST:StrIn TEST:StrIn                     HelloWorld