unix/fiss

src/fsvc/fsvc.8.txt in master
Repositories | Summary | Log | Files | LICENSE

fsvc.8.txt (2828B) download


  1@man fsvc 8 "MAY 2023" "%VERSION%" "fiss man page"
  2@header fsvc(8) %VERSION%
  3
  4@title name Name
  5
  6*fsvc* - fiss' service controller
  7
  8
  9@title synopsis Synopsis
 10
 11*fsvc* *start* [_options_] [*--pin_*] <service>
 12
 13*fsvc* *stop* [_options_] [*--pin*] <service>
 14
 15*fsvc* *enable* [_options_] [*--once*] <service>
 16
 17*fsvc* *disable* [_options_] [*--once*] <service>
 18
 19*fsvc* *kill* [_options_] <service> <signal|signo>
 20
 21*fsvc* *status* [_options_] [*--check*] [<service>]
 22
 23*fsvc* *pause* [_options_] <service>
 24
 25*fsvc* *resume* [_options_] <service>
 26
 27*fsvc* *switch* [_options_] [*--reset*] <runlevel>
 28
 29
 30@title description Description
 31
 32*fsvc* is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
 33
 34@title options Options
 35
 36The following options are available for every command:
 37
 38@list
 39*-q, --short*
 40Will print brief information about the service.
 41
 42*-r, --runlevel <runlevel>*
 43Will use fBrunlevelfB instead of _default_.
 44
 45*-s, --service-dir <path>*
 46Will use *path* as service directory instead of _/etc/fiss/service.d_.
 47
 48*-v, --verbose*
 49Prints verbose information.
 50
 51*-V, --version*
 52Prints the version and exits.
 53
 54The following options are available per command:
 55
 56*-p, --pin*
 57Pins the state. If issued with *start* it will cause the service to restart.
 58If issued with *stop* it will cause the service to be hold down.
 59
 60*-o, --once*
 61Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
 62
 63*-c, --check*
 64Command will return _0_ if the specified service is active otherwise _1_
 65
 66*-r, --reset*
 67Specifies that the switch command should reset all running services (if manually set to up/down)
 68@endlist
 69
 70@title commands Commands
 71
 72The following commands are available:
 73
 74@list
 75*start*
 76Starts the specified service. A synonym is *up*.
 77
 78*stop*
 79Stops the specified service. A synonym is *down*.
 80
 81*enable*
 82Enables the specified service, causing it to automatically start on subsequent bootups.
 83
 84*disable*
 85Disables the specified service, causing it to not start automatically on subsequent bootups.
 86
 87*kill*
 88Sends the specified signal or signal number to the specified service. A synonym is *send*.
 89
 90*status*
 91Displays the status of the specified service. If no service is specified, displays the status of all services.
 92
 93*pause*
 94Pauses the specified service.
 95
 96*resume*
 97Resumes the specified service.
 98
 99*switch*
100Switches the runlevel to the specified value.
101@endlist
102
103@title see See ALSO
104
105finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
106
107@title author Author
108
109Friedel Schön <[email protected]>