serv/README.md

79 lines
2.1 KiB
Markdown
Raw Normal View History

2021-07-11 10:20:48 +10:00
# Overview
Script to manage custom./etc/services entries.
# Usage
2021-07-11 10:22:19 +10:00
Show usage
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh -h
usage: ./serv.sh [OPTIONS] command [command_args]
Manage custom /etc/services entries.
Valid commands are: diff sync init add del query cat
-f Force removal of service even if multiple match.
-w Update system services file (/etc/services)
-y Same as -w
2021-07-11 10:22:19 +10:00
Create working area in ~/.serv/
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh init
Initialisation of /Users/rpearce/.serv complete.
2021-07-11 10:22:19 +10:00
Add a custom service
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh add myservice 34777/udp
Added 'myservice' (34777/udp) to custom services file.
NOTE: /etc/services not touched - use -w to update it.
The following changes were NOT made:
13921a13922,13924
>
> # custom services from serv.sh
> myservice 34777/udp
2021-07-11 10:22:19 +10:00
Look up a custom service
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh query myservice
Found in custom services file:
myservice 34777/udp
2021-07-11 10:22:19 +10:00
Update system /etc/services with custom services
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh -w sync
(using sudo - you may be prompted for your password)
Password:
/etc/services updated:
13921a13922,13924
>
> # custom services from serv.sh
> myservice 34777/udp
rpearce@crom:serv$ tail -5 /etc/services
# 48557-49150 Unassigned
# 49151 IANA Reserved
# custom services from serv.sh
myservice 34777/udp
rpearce@crom:serv$
2021-07-11 10:22:19 +10:00
Remove a custom service, and also update /etc/services
2021-07-11 10:20:48 +10:00
rpearce@crom:serv$ ./serv.sh -w rm myservice
Removed 'myservice' from custom services file (1 line).
(using sudo - you may be prompted for your password)
/etc/services updated:
13924d13923
< myservice 34777/udp
rpearce@crom:serv$ tail -5 /etc/services
com-bardac-dw 48556/udp # com-bardac-dw
com-bardac-dw 48556/tcp # com-bardac-dw
# Nicholas J Howes <nick@ghostwood.org>
# 48557-49150 Unassigned
# 49151 IANA Reserved
rpearce@crom:serv$