touch-als 0.4.0

...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

<!--
==--==--==--==--==--==--==--==--==--==--==--==--==--==--==--==--

touch-als

Copyright (C) 2021, 2024  Anonymous



This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

::--::--::--::--::--::--::--::--::--::--::--::--::--::--::--::--
-->

## Project

-   _This project follows [Semantic Versioning 2.0.0]_
-   License: GNU Lesser General Public License, either version 3, or (at your option) any later version.

## Features

<!-- PROGRAM-DOCS:START -->

`touch-als` is a simple Linux program. It helps with automation tasks involving abstract sockets.

Current features are simple:

-   User can run `touch-als` and pass it one or more abstract Linux socket address(es). The program will touch those address(es), by connecting to and immediately dropping the connection(s).

-   For single address per invocation, the program supports running one sub command, based on user condition:

    +   If the address is alive (on-success).
    +   Or if the address is _not_ alive (on-failure).

-   Addresses are either:

    +   Hexadecimal strings. They must have at least one byte, and at most 107 bytes. Based on `unix(7)`, abstract Linux socket paths can have up to 108 bytes. The program dictates that it takes control of the first byte -- which will always be zero (`0`). If the user provides less than 107 bytes, the rest will be filled with zeros.

    +   Raw strings, prefixed with `raw:`.

-   Sub command and its arguments can be provided after a double-hyphen phrase: `--`.

<!-- PROGRAM-DOCS:END -->

To see more details, options and examples..., you can run the program with `help` command.

[Semantic Versioning 2.0.0]: https://semver.org/spec/v2.0.0.html