fiss

Friedel's Initialization and Service Supervision
Log | Files | Refs | LICENSE

fsvc.8.txt (2828B)

      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 
     36 The following options are available for every command:
     37 
     38 @list
     39 *-q, --short*
     40 Will print brief information about the service.
     41 
     42 *-r, --runlevel <runlevel>*
     43 Will use fBrunlevelfB instead of _default_.
     44 
     45 *-s, --service-dir <path>*
     46 Will use *path* as service directory instead of _/etc/fiss/service.d_.
     47 
     48 *-v, --verbose*
     49 Prints verbose information.
     50 
     51 *-V, --version*
     52 Prints the version and exits.
     53 
     54 The following options are available per command:
     55 
     56 *-p, --pin*
     57 Pins the state. If issued with *start* it will cause the service to restart.
     58 If issued with *stop* it will cause the service to be hold down.
     59 
     60 *-o, --once*
     61 Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
     62 
     63 *-c, --check*
     64 Command will return _0_ if the specified service is active otherwise _1_
     65 
     66 *-r, --reset*
     67 Specifies that the switch command should reset all running services (if manually set to up/down)
     68 @endlist
     69 
     70 @title commands Commands
     71 
     72 The following commands are available:
     73 
     74 @list
     75 *start*
     76 Starts the specified service. A synonym is *up*.
     77 
     78 *stop*
     79 Stops the specified service. A synonym is *down*.
     80 
     81 *enable*
     82 Enables the specified service, causing it to automatically start on subsequent bootups.
     83 
     84 *disable*
     85 Disables the specified service, causing it to not start automatically on subsequent bootups.
     86 
     87 *kill*
     88 Sends the specified signal or signal number to the specified service. A synonym is *send*.
     89 
     90 *status*
     91 Displays the status of the specified service. If no service is specified, displays the status of all services.
     92 
     93 *pause*
     94 Pauses the specified service.
     95 
     96 *resume*
     97 Resumes the specified service.
     98 
     99 *switch*
    100 Switches the runlevel to the specified value.
    101 @endlist
    102 
    103 @title see See ALSO
    104 
    105 finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
    106 
    107 @title author Author
    108 
    109 Friedel Schön <[email protected]>