https://github.com/essentialkaos/kaosv

Bash lib for SysV init scripts
https://github.com/essentialkaos/kaosv

initrd initscript sysv

Last synced: 7 months ago
JSON representation

Bash lib for SysV init scripts

• Host: GitHub
• URL: https://github.com/essentialkaos/kaosv
• Owner: essentialkaos
• License: apache-2.0
• Created: 2015-12-15T11:24:26.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2024-12-16T12:35:05.000Z (about 1 year ago)
• Last Synced: 2025-03-24T10:01:32.460Z (11 months ago)
• Topics: initrd, initscript, sysv
• Language: Shell
• Homepage: https://kaos.sh/kaosv
• Size: 158 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          




  

  



Documentation • Examples • Common mistakes • CI Status • License





`kaosv` is bash lib for SysV init scripts.

### Documentation

KAOSv contain inline documentation in shdoc format.

Documentation for latest version can be found [here](https://docs.kaos.st/kaosv/latest/). Also you can use [SHDoc](https://github.com/essentialkaos/shdoc) utility for viewing inline docs in your console.

### Examples

* [memcached](https://github.com/essentialkaos/kaos-repo/blob/master/specs/memcached/SOURCES/memcached.init)

* [pgbouncer](https://github.com/essentialkaos/kaos-repo/blob/master/specs/pgbouncer/SOURCES/pgbouncer.init)

* [postgresql](https://github.com/essentialkaos/kaos-repo/blob/master/specs/postgresql-11/SOURCES/postgresql.init)

* [redis](https://github.com/essentialkaos/kaos-repo/blob/master/specs/redis/SOURCES/redis.init)

* [salt](https://github.com/essentialkaos/kaos-repo/blob/master/specs/salt/SOURCES/salt-master.init)

* [webkaos](https://github.com/essentialkaos/webkaos/blob/master/SOURCES/webkaos.init)

### Common mistakes

**Checking the system environment before executing `kv.go`**

You should define a pre-start handler with [disabled output redirect](https://docs.kaos.st/kaosv/2.15.3/#491) and perform system check in this handler ([example](https://github.com/essentialkaos/kaos-repo/blob/master/specs/pgbouncer/SOURCES/pgbouncer.init#L86)).

**The script doesn't run application and return a non-zero exit code**

All handlers must always return action status code (`ACTION_OK`, `ACTION_ERROR`, `ACTION_FORCED`) otherwise it can be exit code from the last command performed in this handler.

### CI Status

| Branch | Status |

|--------|--------|

| `master` | [![CI](https://kaos.sh/w/kaosv/ci.svg?branch=master)](https://kaos.sh/w/kaosv/ci?query=branch:master) |

| `develop` | [![CI](https://kaos.sh/w/kaosv/ci.svg?branch=master)](https://kaos.sh/w/kaosv/ci?query=branch:develop) |

### License

[Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0)