Skip to content
Snippets Groups Projects
Commit cf6a7239 authored by Eric Vidal's avatar Eric Vidal :speech_balloon:
Browse files

add documentation about -R option at 66-disable command

parent 0ddeea27
No related branches found
No related tags found
No related merge requests found
......@@ -10,7 +10,7 @@ author: Eric Vidal <eric@obarun.org>
## Interface
```
66-disable [ -h ] [ -z ] [ -v verbosity ] [ -l live ] [ -t tree ] [ -S ] [ -F ] service(s)
66-disable [ -h ] [ -z ] [ -v verbosity ] [ -l live ] [ -t tree ] [ -S ] [ -F ] [ -R ] service(s)
```
This tool expects to find an already enabled *service* inside the given *tree*. The targeted service(s) can also be stopped on the fly when disabling it with the **-S** option. Generally speaking this command is the strict opposite of the [66-enable](66-enable.html) tool.
......@@ -43,6 +43,8 @@ Multiple *services* can be disabled by seperating their names with a space.
- **-F** : forces the *service* to be disabled even if it's already marked disabled. The *service* **must** be marked uninitialized —see [66-intree](66-intree.html). The dependency of the *service* is **not** handled except for its associated logger. Also, this option cannot be used for a logger service. This option should only be used when an inconsistent state exist between the actual contents of the compiled service database and the display of the contents of a tree with the [66-intree](66-intree.html) command. For example, if you disable a service and a power failure occur, the service will be marked uninitialized and disabled at the next boot inside your tree. In this case use this option to cleanup your tree.
- **-R** : disable and remove its configuration and logger files. The *service* **must** be marked uninitialized —see [66-intree](66-intree.html). The dependency of the *service* **is** handled. Also, this option cannot be used for a logger service.
## Dependencies handling
In case of `bundle`, `module` or `'atomic'` services, any dependency chain will be automatically resolved. It is unnecessary to manually define chained sets of dependencies. If FooA has a declared dependency on FooB, FooB will be automatically disabled as well when disabling FooA. This will run recursively until all dependencies are disabled.
......@@ -51,7 +51,7 @@ char const *help_dbctl =
" -r: reload service\n"
;
char const *usage_disable = "66-disable [ -h ] [ -z ] [ -v verbosity ] [ - l live ] [ -t tree ] [ -S ] [ -F ] service(s)" ;
char const *usage_disable = "66-disable [ -h ] [ -z ] [ -v verbosity ] [ - l live ] [ -t tree ] [ -S ] [ -F ] [ -R ] service(s)" ;
char const *help_disable =
"66-disable <options> service(s)\n"
......@@ -64,6 +64,7 @@ char const *help_disable =
" -t: name of the tree to use\n"
" -S: disable and stop the service\n"
" -F: forces to disable the service\n"
" -R: disable the service and remove its configuration and logger files\n"
;
char const *usage_init = "66-init [ -h ] [ -z ] [ -v verbosity ] [ -l live ] [ -t tree ] classic|database|both" ;
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment