fatalerrors/init.sh
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

bump to version 0.99.18

Browse Source
This commit is contained in:
fatalerrors
2022-06-24 17:52:17 +02:00
parent e8c6f46572
commit da37fd3bae
52 changed files with 1268 additions and 435 deletions
Download Patch File Download Diff File Expand all files Collapse all files

134
doc/errors.md
View File

@@ -33,17 +33,18 @@ You've called the **init.sh** script with command line syntax error or options
that are not compatible together. Some options exclude each others or trigger
opposite events.
To fix it check your command line taking into account of the detailled error
To fix it check your command line taking into account of the detailed error
message displayed together with that error.
## Error #2: Misuse of Bash built-in
A Bash builtin function is uncorrectly called.
A Bash built-in function is incorrectly called.
If that error happens on the execution of a module you made yourself, you might
check the code of your module and fix what goes wrong.
check the code of your module and fix what goes wrong. The backtrace will help
you to find what line is in cause of it.
If it happens on the execution of **init.sh** or a builtin module, please send a
bug repport.
bug report.
## Error #3: Missing library file or function
One of the internal vital function of **init.sh** is missing.
@@ -52,19 +53,19 @@ Most of the time that error happens when one of the library files of **init.sh**
is missing. Please check your directory tree and all files are available. Use
git as a reference if you have some doubts.
If you have all the files, make sure they are not truncated (it can happens, for
example, if disk is full), that you use consistant versions (yet again, git is
the reference) or you didn't modified something accidentally in libraries or
If you have all the files, make sure they are not truncated (it can happen, for
example, if disk is full), that you use consistent versions (yet again, git is
the reference) or you didn't modify something accidentally in libraries or
**init.sh** script.
## Error #4: No root right
You tried to execute **init.sh** without administrative rights.
As **init.sh** goal is to transform system, administrative rights are absolutely
necessary. To fix this, run **init.sh** as superuser, using ```sudo``` or
```su```.
As **init.sh** goal is to transform the system, administrative rights are
absolutely necessary. To fix this, run **init.sh** as superuser, using
```sudo``` or ```su```.
If you run as non UID #0 user but you're certain to have all the necessary
If you run as non UID #0 user, but you're certain to have all the necessary
rights, you have to use the ```--no-check-root``` option.
## Error #5: Malformed module list
@@ -72,9 +73,9 @@ The module list you provided is malformed or contains forbidden characters.
To fix this, check your module list in your configuration file or in your
command line if you passed it manually. If you created a module you added in the
list, make sure your module does not contain a dash '-' character, or any non
alphanumeric character other than underscore. If you use a number in your module
name, make sure it's not begining with.
list, make sure your module does not contain a dash '-' character, or any
non-alphanumeric character other than underscore. If you use a number in your
module name, make sure it's not beginning with.
## Error #6: Unable to find configuration
That error happens when no configuration file suitable for your machine have
@@ -82,84 +83,86 @@ been found.
To fix this, make sure you have a configuration file named after the lowercase
hostname of the computer you run on in the ```conf/``` directory of your
**init.sh** tree. Alternatively you can use a generic file named
**init.sh** tree. Alternatively, you can use a generic file named
```init.conf.sh``` in that same directory.
If you gave manual configuration files, check they all exists.
If you gave manual configuration files, check they all exist.
## Error #7: Misuse of script internal function
One of the base function of **init.sh** libraries is not being used correctly.
If that error happens while executing one of your module, please check your code
especially when you use a **init.sh** internal. The
[developper documentation](dev.md) will help you about synthax. Check your
If that error happens while executing one of your module, please check your
code, especially when you use an **init.sh** internal. The
[developer's documentation](dev.md) will help you about syntax. Check your
parameters are correctly passed in the good format and do not use wildcards in
file names.
If it happens on the execution of **init.sh** or a builtin module, please send a
bug repport.
If it happens on the execution of **init.sh** or a built-in module, please send
a bug report.
## Error #8: Can't determine OS type or version
As **init.sh** relies on some specific operating system commands (like package
manager) the detection system must be able to obtain OS characteristics.
To fix this you must check the ```/etc/os-release``` file availability for your
To fix this, you must check the ```/etc/os-release``` file availability for your
distribution. If your distribution do not provide that file, you'll have to
create it yourself providing on the bare minimum an ``ID`` entry. Check the
create it yourself, providing on the bare minimum an ``ID`` entry. Check the
[```/etc/os-release``` file documentation](https://www.freedesktop.org/software/systemd/man/os-release.html)
for details.
## Error #9: Unsatisfied dependency
That error can happens in two cases scenario. One case is one or more of your
That error can happen in two cases scenario. One case is one or more of your
modules depends on another which is not part of the module to execute. The other
case is when you call a module too early.
case is when you call a module too early in the list.
To fix this, check your module list order. Check also your modules dependenies
are in the list before they are called themself.
To fix this, check your module list order. Check also your module's dependencies
are in the list before they are called themselves.
If you wrote your own module, make sure you have no circular dependencies.
## Error #10: File missing or empty
You have refered a file that don't exists or is empty, if the file is required
You have referred a file that don't exist or is empty, if the file is required
to have a content.
Check your filename and path in modules and/or configuration files.
## Error #11: Bad function call
That error is trigered when an internal function is called with a wrong number
That error is triggered when an internal function is called with a wrong number
of parameters.
If that error happens while executing one of your module, please check your code
especially when you use a **init.sh** internal. The
[developper documentation](dev.md) will help you about synthax.
If that error happens while executing one of your module, please check your
code, especially when you use an **init.sh** internal. The
[developer's documentation](dev.md) will help you about syntax. Check also if a
required variable is properly set. It's always a good idea to test if all needed
variables are set properly in the checks, before applying any changes.
If it happens on the execution of **init.sh** or a builtin module, please send a bug
repport.
If it happens on the execution of **init.sh** or a built-in module, please send
a bug report.
## Error 12: Error copying files
A file copy opperation have failed.
A file copy operation has failed.
Make sure your source path exists and is readable and destination is writable
and target directory exists. Chack also if target do not contain a symbolic link
and target directory exists. Check also if target do not contain a symbolic link
or a directory with the same name.
## Error #13: Bad target file system
The target file system you provided is not part of the root filesystem, is not
accessible or is not an absolute path.
The target file system you provided is not part of the root file system, is not
accessible, or is not an absolute path.
Make sure your destination paths are fully qualified paths names (begining with
Make sure your destination path is a fully qualified paths names (beginning with
"/"), is writable and the destination path exists.
## Error #14: Impossible to chroot
That error occurs when the chroot target don't exists.
That error occurs when the chroot target don't exist.
Check your target filesystem, make sure it's mounted.
Check your target file system, make sure it's mounted.
## Error #15: Bad chrooted installation, destination OS needs to be fixed
The target installation is incomplete or not usable in a chrooted environment.
Check all the filesystems needed to perform the chroot are mounted correctly. If
your target installation is damaged, you have to fix it before running
Check all the file systems needed to perform the chroot are mounted correctly.
If your target installation is damaged, you have to fix it before running
**init.sh**.
## Error #16: Invalid options provided with cron mode activated
@@ -174,44 +177,49 @@ You asked to resume on last error, but no status file can be found.
To fix this, remove the ```--resume``` option. You can use the ```--modules```
option instead to ask for a limited range of modules.
## Error #18: Module file don't exists or is empty
## Error #18: Module file don't exist or is empty
The module list contains an entry that correspond to no module in the "modules"
directory or the corresponding file is actually empty.
directory, or the corresponding file is actually empty.
Check the spelling of the incriminated module. If spelling is correct, check the
file name of that module. If it don't exists, create the module or remove it
from the module list.
file name of that module. If it don't exist, create the module or remove it from
the module list.
## Error #50 to #100: Error in module execution
A module trigered an internal error while executing change to the system. You
A module triggered an internal error while executing changes to the system. You
need to check the concerned module documentation.
As the module may have done some unfinished changes to the system, it will be
safer to resume after fixing the problem before rebooting.
safer to resume after fixing the problem before rebooting. If you need to
reboot, please check your system is still bootable.
## Error #126: Command exists but is not executable
You try to execute a command that is not executable for you.
Check your rights to execute the so said command. Check also the excutable is
valid if the command is external.
Check your rights to execute the so said command. Check also the executable file
is valid if the command is external.
## Error #127: Command not found
You try to call a command that do not exists.
You try to call a command that do not exist.
If taht error comes from one of your modules, check the spelling of the
command. Check also if the program you need is installed and think about
installing it through the provided **init.sh** builtin functions.
If that error comes from one of your modules, check the spelling of the
command. Check also if the program you need is installed, and think about
installing it through the provided **init.sh** built-in functions before using
it in your module.
If that occurs with a builtin module or in **init.sh** code or libraries please
fill a bug repport.
If that occurs with a built-in module or in **init.sh** code or libraries,
please fill a bug report.
## Error #128: Abortion due to external cause
That error happens when an exeternal signal is triggering a stop in the
That error happens when an external signal is triggering the interuption of the
execution of **init.sh**.
Do not halt or restart the computer before the end of **init.sh** execution.
Using Ctrl + C sequence or the kill command on the bash process running the
script will lead to that error too.
Do not halt or restart the computer before the end of **init.sh** execution. If
one of your module requires a reboot, please use the built-in ```need_reboot```
command.
Note that using Ctrl + C sequence or the kill command on the bash process
running the script will lead to that error too.
## Error #150 to #200: Error in module checks
One of the checks executed prior **init.sh** actions did not pass.
@@ -223,12 +231,12 @@ the associated error message.
That error is a special case when the exit status of a program is above 255 as
authorized by many high level programming languages.
Check the error in the program emiting it and the associated program
Check the error in the program emitting it and the associated program
documentation.
-----------------------------------------------------------------------------
Documentation (c) 2019-2021 Geoffray Levasseur.
Documentation (c) 2019-2022 Geoffray Levasseur.
This file is distributed under3-clause BSD license. The complete license
agreement can be obtained at: https://opensource.org/licenses/BSD-3-Clause