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
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值