1. Overview

utilx9 是一個集合常用的 Open-source 而後衍生出來的 library.

主要訴求是 - 應用簡單化！ 強化常用、有用的功能！

大家都知道 Open-source 功能強大，貢獻非凡！提供前所未有的視野，讓開發者們省去大半的研究時間，開發更有效率嗎？也因此我們不是要深究 Open-source 是如此高深，而是要知悉如何應用。

經過多年的工作經驗，心想只是為了糊口飯吃，為什麼還要浪費在這些 Open-source 的文件裏打轉，於是一點一滴才整理出這些.

It is hard to read any usages of Open-source. They are lengthy. utilx9 is the utility api. Here giving small api packages and easily to use. We can also get the ideals from the demo programs

2. Depend on

2.1. Open-source

- curl (PJ_HAS_CURL / UTIL_EX_CURL)

- dbus (PJ_HAS_DBUS / UTIL_EX_DBUS)

$ sudo apt -y install libdbus-1-dev

- fcgi2 (PJ_HAS_FASTCGI / UTIL_EX_FASTCGI)

- jansson (PJ_HAS_JANSSON / UTIL_EX_JSON)

$ sudo apt -y install libjansson-dev

- json-c (PJ_HAS_JSONC)

- libbacktrace (PJ_HAS_LIBBACKTRACE / UTIL_EX_BACKTRACE)

- libnl-tiny (PJ_HAS_LIBNL_TINY)

- libssh (PJ_HAS_LIBSSH / UTIL_EX_SSH)

- libubox (PJ_HAS_LIBUBOX / UTIL_EX_UBOX)

- libusb (PJ_HAS_LIBUSB / UTIL_EX_USB)

- libuv (PJ_HAS_LIBUV / UTIL_EX_UV)

- libwebsockets (PJ_HAS_LIBWEBSOCKETS / UTIL_EX_WEBSOCKETS)

$ sudo apt -y install libwebsockets-dev

- libyuarel (PJ_HAS_LIBYUAREL / UTIL_EX_YUAREL)

- mosquitto (PJ_HAS_MOSQUITTO / UTIL_EX_MQTT)

$ sudo apt -y install libmosquitto-dev

- mxml (PJ_HAS_MXML / UTIL_EX_MXML)

(need to patch, please check patches/mxml-2.11)

- openssl (PJ_HAS_OPENSSL / UTIL_EX_SSL)

- swconfig (PJ_HAS_SWCONFIG / UTIL_EX_SWCONFIG)

openwrt/package/network/config/swconfig

- ubus (PJ_HAS_UBUS)

- uci (PJ_HAS_UCI / UTIL_EX_UCI)

2.2. Internet Notes

- internet-collect.c - Hex Encode and Decode in C

- internet-collect.c - Linux C语言实现urlencode和urldecode

- internet-collect.c - Howto base64 encode and decode with C and OpenSSL

- internet-collect.c - 34.1 Backtraces

- clist_api.c - http://www.contiki-os.org

- crc16.c - http://www.contiki-os.org

- crc32alg.c - CRC32 code derived from work by Gary S. Brown.

- chainX_api.c - Linux RS-232 程式設計

- lws_123.c - simple-libwebsockets-example

- lws_api.c - multithread call lws_callback_on_writable to send data ASAP

- nlink_123.c - Monitoring Linux networking state using netlink

- nlink_456.c - Port status polling via swconfig kernel module

- utilx9.h - 解读 /proc/$PID/status 中各种参数

- utilx9.h - RTP Library in C

3. Current Status

因為這是多年工作下的成果，一定還有發展空間.如果有 bug 請多多包函.

4. Build

$ . confs/simple_x86.conf
#$ . confs/sh/customer2def.sh
# to create
# include/customer_def.h
# include/config_customer
# include/config_customer.export
# include/meson_options.txt
$ make
$ make install
# will be installed ${SDK_ROOT_DIR} - ./install/github_
$ make romfs
# will be installed ${HOMEX_ROOT_DIR} - ./install/github_rootfs
$ make target_install 
# will be installed ${PJ_INSTALL_TARGET} - /work/rootfs

# 上面過於複雜，簡單化
$ ./build-make.sh build

4.1. environment (without libmxml and libyuarel)

$ sudo apt-get --yes install libjansson-dev
$ sudo apt-get --yes install libuv1-dev

$ sudo apt-get --yes install libdbus-1-dev
#or
$ sudo apt-get --yes install libdbus-dev

$ cd /usr/include
$ sudo ln dbus-1.0/dbus/ -s dbus
$ cd /usr/include/dbus
$ sudo cp /usr/lib/x86_64-linux-gnu/dbus-1.0/include/dbus/dbus-arch-deps.h ./

$ sudo apt-get --yes install libwebsockets-dev

$ sudo apt-get --yes install libusb-dev
$ sudo apt-get --yes install libusb-1.0-0-dev

$ sudo apt-get --yes install libmosquitto-dev
$ sudo apt-get --yes install libjson-c-dev

4.2. Other Libraries

A. libmxml

$ vi conf/simple_x86.conf
export PJ_HAS_MXML=yes

$ vi utilx9.h
#define UTIL_EX_MXML

#please patch mxml-2.11 with patches/mxml-2.11

B. libyuarel

$ vi conf/simple_x86.conf
export PJ_HAS_LIBYUAREL=yes

$ vi utilx9.h
#define UTIL_EX_YUAREL

C. libbacktrace

$ vi conf/simple_x86.conf
export PJ_HAS_LIBBACKTRACE=yes

$ vi utilx9.h
#define UTIL_EX_BACKTRACE

5. Example or Usage

- backtrace_123 - backtrace example.

$ ./backtrace_123
*** stack smashing detected ***: terminated
[20143/20143] app_signal_handler:88 - (signum: 6)
[20143/20143] backtrace_alert:373 - ===== Obtained 10 stack frames =====
/work/codebase/lankahsu520/utilx9/libutilx9.so.3(backtrace_alert+0x2e) [0x7f24e60030ce]
/lib/x86_64-linux-gnu/libc.so.6(+0x43090) [0x7f24e5c88090]
/lib/x86_64-linux-gnu/libc.so.6(gsignal+0xcb) [0x7f24e5c8800b]
/lib/x86_64-linux-gnu/libc.so.6(abort+0x12b) [0x7f24e5c67859]
/lib/x86_64-linux-gnu/libc.so.6(+0x8d26e) [0x7f24e5cd226e]
/lib/x86_64-linux-gnu/libc.so.6(__fortify_fail+0x2a) [0x7f24e5d74cda]
/lib/x86_64-linux-gnu/libc.so.6(+0x12fca6) [0x7f24e5d74ca6]
./backtrace_123(+0x16a8) [0x5562fcd6e6a8]
./backtrace_123(+0x12e5) [0x5562fcd6e2e5]
/lib/x86_64-linux-gnu/libc.so.6(__libc_start_main+0xf3) [0x7f24e5c69083]
[20143/20143] backtrace_alert:380 - ====================================
Aborted (core dumped)

$ addr2line -Cfie backtrace_123 +0x16a8
function_deep_2
/work/codebase/lankahsu520/utilx9/backtrace_123.c:62

$ addr2line -Cfie backtrace_123 +0x12e5
main
/work/codebase/lankahsu520/utilx9/backtrace_123.c:187

- backtrace_456 - libbacktrace example.

export PJ_HAS_LIBBACKTRACE=yes, use backtrace_api.c.

$ ./backtrace_456
*** stack smashing detected ***: terminated
[37049/37049] app_signal_handler:88 - (signum: 6)
0x7ff0d25ee7b0 backtraceX_alert
        /work/codebase/lankahsu520/utilx9/backtrace_api.c:69
0x7ff0d224d08f ???
        /build/glibc-wuryBv/glibc-2.31/signal/../sysdeps/unix/sysv/linux/x86_64/sigaction.c:0
0x7ff0d224d00b __GI_raise
        ../sysdeps/unix/sysv/linux/raise.c:51
0x7ff0d222c858 __GI_abort
        /build/glibc-wuryBv/glibc-2.31/stdlib/abort.c:79
0x7ff0d229726d __libc_message
        ../sysdeps/posix/libc_fatal.c:155
0x7ff0d2339cd9 __GI___fortify_fail
        /build/glibc-wuryBv/glibc-2.31/debug/fortify_fail.c:26
0x7ff0d2339ca5 __stack_chk_fail
        /build/glibc-wuryBv/glibc-2.31/debug/stack_chk_fail.c:24
0x55d40d6ed6c7 function_deep_2
        /work/codebase/lankahsu520/utilx9/backtrace_456.c:62
0x55d40d6ed30e app_loop
        /work/codebase/lankahsu520/utilx9/backtrace_456.c:71
0x55d40d6ed30e main
        /work/codebase/lankahsu520/utilx9/backtrace_456.c:187
0x7ff0d222e082 __libc_start_main
        ../csu/libc-start.c:308
0x55d40d6ed3fd ???
        ???:0
0xffffffffffffffff ???
        ???:0
7ff0d224d08f ?? ??:0
7ff0d224d00b __GI_raise ../sysdeps/unix/sysv/linux/raise.c:51
7ff0d222c858 __GI_abort /build/glibc-wuryBv/glibc-2.31/stdlib/abort.c:79
7ff0d229726d __libc_message ../sysdeps/posix/libc_fatal.c:155
7ff0d2339cd9 __GI___fortify_fail /build/glibc-wuryBv/glibc-2.31/debug/fortify_fail.c:26
7ff0d2339ca5 __stack_chk_fail /build/glibc-wuryBv/glibc-2.31/debug/stack_chk_fail.c:24
55d40d6ed6c7 function_deep_2 /work/codebase/lankahsu520/utilx9/backtrace_456.c:62
55d40d6ed30e app_loop /work/codebase/lankahsu520/utilx9/backtrace_456.c:71
55d40d6ed30e main /work/codebase/lankahsu520/utilx9/backtrace_456.c:187
7ff0d222e082 __libc_start_main ../csu/libc-start.c:308
55d40d6ed3fd _start ??:0
ffffffffffffffff ?? ??:0
Aborted (core dumped)

- chainX_123 - socket example.

use chainX_api.c.

$ ./chainX_123
[40677/40677] main:131 - dns: 127.0.0.53
[40677/40677] chainX_if_list:364 - (name: lo, flags: 0x10049, family: 2, host: 127.0.0.1, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s3, flags: 0x11043, family: 2, host: 10.0.2.15, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s8, flags: 0x11043, family: 2, host: 192.168.50.52, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s9, flags: 0x11043, family: 2, host: 192.168.56.104, netmask: )
[40677/40677] chainX_if_list:364 - (name: docker0, flags: 0x1003, family: 2, host: 172.17.0.1, netmask: )
[40677/40677] chainX_if_list:364 - (name: lo, flags: 0x10049, family: 10, host: ::1, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s3, flags: 0x11043, family: 10, host: fe80::7549:bd5f:d0ed:32cf%enp0s3, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s8, flags: 0x11043, family: 10, host: fd69:1ac8:5719:2e98:ca8d:19d4:cc66:458f, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s8, flags: 0x11043, family: 10, host: fd69:1ac8:5719:2e98:634d:a07f:2840:758d, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s8, flags: 0x11043, family: 10, host: fe80::d49:8acb:9f1b:c4cf%enp0s8, netmask: )
[40677/40677] chainX_if_list:364 - (name: enp0s9, flags: 0x11043, family: 10, host: fe80::e6d1:c758:6c5c:4cbd%enp0s9, netmask: )

[40677/40677] main:145 - **************************************************
[40677/40677] main:146 - ** enp0s3 **
[40677/40677] main:150 - ip: 10.0.2.15
[40677/40677] main:154 - netmask: 255.255.255.0
[40677/40677] main:158 - broadcast: 10.0.2.255
[40677/40677] main:162 - gateway: 10.0.2.2
[40677/40677] main:166 - ethmac: 08:00:27:33:73:52
[40677/40677] main:169 - ethmac: 080027337352
[40677/40677] main:174 - **************************************************
[40677/40677] main:175 - ** ra0 **
[40677/40677] main:179 - ip:
[40677/40677] main:183 - netmask:
[40677/40677] main:187 - broadcast:
[40677/40677] main:191 - gateway:
[40677/40677] main:195 - ethmac:
[40677/40677] main:198 - ethmac:
[40677/40677] main:202 - ssid:

- client_123 - socket client.

use chainX_api.c.

- clist_123 - link list example.

use clist_api.c , use contiki\core\lib\list.*.

$ ./clist_123
[8338/8338] main:42 - clist_add ~~~ (num: 0)
[8338/8338] main:47 - clist_push ~~~ (num: 1)
[8338/8338] main:47 - clist_push ~~~ (num: 2)
[8338/8338] main:47 - clist_push ~~~ (num: 3)
[8338/8338] main:42 - clist_add ~~~ (num: 4)
[8338/8338] main:47 - clist_push ~~~ (num: 5)
[8338/8338] main:47 - clist_push ~~~ (num: 6)
[8338/8338] main:47 - clist_push ~~~ (num: 7)
[8338/8338] main:42 - clist_add ~~~ (num: 8)
[8338/8338] main:47 - clist_push ~~~ (num: 9)
[8338/8338] main:55 - clist_pop ~~~ (num: 8)
[8338/8338] main:55 - clist_pop ~~~ (num: 4)
[8338/8338] main:55 - clist_pop ~~~ (num: 0)
[8338/8338] main:55 - clist_pop ~~~ (num: 1)
[8338/8338] main:55 - clist_pop ~~~ (num: 2)
[8338/8338] main:55 - clist_pop ~~~ (num: 3)
[8338/8338] main:55 - clist_pop ~~~ (num: 5)
[8338/8338] main:55 - clist_pop ~~~ (num: 6)
[8338/8338] main:55 - clist_pop ~~~ (num: 7)
[8338/8338] main:55 - clist_pop ~~~ (num: 9)

- cronx_123 - crontab example.

parse crontab string ("minute" "hour" "day of month" "month" "day of week" "year, 2020+"), similar to crontab, to use cronx_api.c

$ ./cronx_123 -a "*/1 * * * * 2024 " -d 3
[8985/8985] app_loop:164 - Run loop ... (clock_alarm: [*/1 * * * * 2024 ])
[8985/8985] timer_1sec_loop:51 - (09:30:56)
[8985/8985] timer_1sec_loop:51 - (09:30:57)
[8985/8985] timer_1sec_loop:51 - (09:30:58)
[8985/8985] timer_1sec_loop:51 - (09:30:59)
[8985/8985] timer_1sec_loop:51 - (09:31:00)
[8985/8985] cronx_validate:98 - (cron_txt: [*/1 * * * * 2024 ], [31 9 14 2 4 2024])
[8985/8985] cronx_validate:218 - Got !!! (cron_txt: [*/1 * * * * 2024 ], [31 9 14 2 4 4], fit: 6)
[8985/8985] timer_1sec_loop:65 - Alarm !!! (*/1 * * * * 2024 )
[8985/8985] timer_1sec_loop:51 - (09:31:01)
[8985/8985] timer_1sec_loop:51 - (09:31:02)
^C[8985/8985] app_signal_handler:212 - (signum: 2)
[8985/8985] app_stop:158 - Bye-Bye !!! (cronx_123)
[8985/8985] async_loop:128 - __________ Enter __________
[8985/8985] main:310 - Bye-Bye !!!

- dbusx_456 - dbus example.

export PJ_HAS_DBUS=yes, use dbusx_api.c.

pleae make sure dbusX.conf in /etc/dbus-1/system.d

$ ./dbusx_456 -s &
[30642/30643] dbusx_thread_handler:516 - dbus listen ...
$ ./dbusx_456 -e 123
[3003/3004] demo_signal_name_cb:113 - Got !!! (signal_name: command, reqStr: 123)
[3005/3005] app_loop:150 - (retStr: 123)
[3005/3005] main:284 - Bye-Bye !!!
[3003/3004] demo_signal_name_cb:113 - Got !!! (signal_name: DBUS_TYPE_INT16, reqStr: 16)
[3003/3004] demo_signal_name_cb:113 - Got !!! (signal_name: DBUS_TYPE_INT32, reqStr: 32)
[3003/3004] demo_signal_name_cb:113 - Got !!! (signal_name: DBUS_TYPE_INT64, reqStr: 64)

- demo_000 - c template.

$ ./demo_000
[3011/3011] app_loop:46 - (pid: 3011)
[3011/3011] app_loop:50 - (cksum: 1398)
[3011/3011] app_loop:52 - (cksum: 22044)
[3011/3011] main:156 - Bye-Bye !!!

- demo_123 - a example.

$ ./demo_123
[3013/3013] main:44 - String testing ...
[3013/3013] main:45 - (1<<3: 0x00000008, 1<<14: 0x00004000, 1<<15: 0x00008000, 1<<16: 0x00010000, 1<<17: 0x00020000)
[3013/3013] main:48 - (hello org: Hello World !!!    )
[3013/3013] main:50 - (hello_trim: Hello World !!!)
[3013/3013] main:58 - SAFE_STRCAT_EX - lankahsu520/1234

[3013/3013] main:83 - BASE64, abc -> abc_enc -> abc_dec
[3013/3013] main:87 - (sec_base64_enc: cnRzcDovLzE5Mi4xNjguNTAuMjM4OjU1NC9saXZlMS5zZHA=)
[3013/3013] main:90 - (sec_base64_dec: rtsp://192.168.50.238:554/live1.sdp)

[3013/3013] main:111 - aes_128_cbc, intlen: 15, plaintext: 123456789012345 -> plaintext_enc -> plaintext_dec
[3013/3013] main:112 - (evp_key: 1234567890abcdef, iv_key: 1234567890abcdef)
[3013/3013] main:117 - sec_aes_cbc_enc - plaintext_enc: {
    93 EE E4 5D 7F 89 2D 25 CE 24 F1 BD 78 40 67 62
}
▒7▒#x/30▒▒p▒=S▒"▒▒w▒▒#x(▒▒p▒=S▒"▒▒w▒▒#x ▒▒p▒=S▒"▒▒w▒▒#x:▒▒p▒=S▒"▒▒w▒▒#x5▒▒p▒=S▒"▒▒w▒▒#x ▒▒p▒=S▒"▒▒w▒▒)

[3013/3013] main:127 - sec_aes_cbc_encX - enc_len: 16, plaintext_enc: {
    93 EE E4 5D 7F 89 2D 25 CE 24 F1 BD 78 40 67 62
}
[3013/3013] main:129 - (sec_aes_cbc_decX - dec_len: 15, plaintext_dec: 123456789012345)

[3013/3013] main:147 - hostname ...
[3013/3013] main:150 - (gethostname: build20-vbx)
[3013/3013] main:154 - (getdomainname: (none), res: 0)

[3013/3013] main:189 - datetime ...
[3013/3013] main:190 - (time_now_full: 2024-03-14 09:43:34)

- http_client_123 - http client example.

export PJ_HAS_CURL=yes, use curl_api.c.

- jqx - it is similar to jq.

jqx only support reads from pipe.

# please download Music.json (https://github.com/lankahsu520/HelperX/blob/master/AWS/Music.json)
$ cat Music.json | ./jqx .Items[3].Sponsor.L[].S
"dog"
"cat"
"mouse"
"stoat"
"snake"

- json_123 - json example.

export PJ_HAS_JANSSON=yes, use json_api.c.

$ ./json_123
[3032/3032] main:32 - enter
[3032/3032] uuid_test:21 - (guid: 7CE07D29-CFA5-417B-a4BF-51AD96BFCB3C)
[3032/3032] uuid_test:24 - (guid: 059D6F66-9537-4B6E-bCD7-48B204C59381)
[3032/3032] uuid_test:27 - (guid: 6E632715-5EEE-449E-8CB4-8049F0856661)
[3032/3032] json_dump_simple:22 - (jroot: {"j1":{"j2":{"j3":{"logo":"helloworld!!!"}}}})
[3032/3032] main:52 - >> update j4->j1
[3032/3032] json_dump_simple:22 - (jroot: {"j1":{"j4":"child !!!"}})
[3032/3032] json_dump_simple:22 - (jroot: {"j1":{"j4":"child !!!"},"jA":[{"name":"A1","val":1},{"name":"A2","val":2},{"name":"A3","val":3}]})
[3032/3032] main:95 - >> (jA: 0x55a05def06e0, jA_new: 0x55a05def06e0)
[3032/3032] main:102 - >> update jB1->jA1
[3032/3032] json_dump_simple:22 - (jroot: {"j1":{"j4":"child !!!"},"jA":[{"name":"A1","nameB":"B4","val":1,"valB":4},{"name":"A2","val":2},{"name":"A3","val":3}]})
[3032/3032] json_dump_simple:22 - (jroot: {"demo":"HelloWorld 1 !!!","j1":{"j4":"child !!!"},"jA":[{"name":"A1","nameB":"B4","val":1,"valB":4},{"name":"A2","val":2},{"name":"A3","val":3}]})
[3032/3032] main:120 - >> set demo as jdemo1 (jdemo1: 0x55a05def04c0, refcount: 1)
[3032/3032] json_dump_simple:22 - (jroot: {"demo":"HelloWorld 2 !!!","j1":{"j4":"child !!!"},"jA":[{"name":"A1","nameB":"B4","val":1,"valB":4},{"name":"A2","val":2},{"name":"A3","val":3}]})
[3032/3032] main:125 - >> set demo as jdemo2; jdemo1 will be free and we can't access jdemo1 !!! !!! (jdemo2: 0x55a05def0860, refcount: 1)
[3032/3032] json_dump_simple:22 - (jroot: {"demo":"HelloWorld 2 !!!","j1":{"j4":"child !!!"},"jA":[{"name":"A1","nameB":"B4","val":1,"valB":4},{"name":"A2","val":2},{"name":"A3","val":3}]})
[3032/3032] main:135 - (idx: 2)
[3032/3032] json_dump_simple:26 - (Not Found - j1/j2/j4: (nil))
[3032/3032] json_dump_simple:22 - (APPEND - j1/j2/j4: {})
[3032/3032] json_dump_simple:26 - (DEL - j1/j2/j3: (nil))
[3032/3032] json_dump_simple:22 - (j1/j2: {"j4":{}})
[3032/3032] main:208 - (sunrise: 3:22:56 AM)
[3032/3032] main:209 - (sunset: 5:10:20 PM)
[3032/3032] main:210 - (utc: 1652853043)
[3032/3032] main:228 - (cJson: {"sunrise":"3:22:56 AM","sunset":"5:10:20 PM","time_utc":1652853043})

- led_123 - led controller example.

- lws_123 - a websocket example.

export PJ_HAS_LIBWEBSOCKETS=yes, use lws_api.c.

- mqtt_123 - a mqtt example.

export PJ_HAS_MOSQUITTO=yes, use mqtt_api.c.

- multicast_cli & multicast_srv - multicast example.

use multicast_api.c.

很多應用都有用到 multicast，SSDP (Simple Service Discovery Protocol)、mDNS / DNS-SD (Bonjour, Avahi, Zeroconf)、WS-Discovery 等。

$ ./multicast_srv
listen ... (239.255.255.250:3618)
setsockopt IP_ADD_MEMBERSHIP
10.0.2.15 - 0
10.0.2.15 - 1
10.0.2.15 - 2
10.0.2.15 - 3
10.0.2.15 - 4

$ ./multicast_cli
link ... (239.255.255.250:3618, argc: 1)
sendto (buff: 0)
sendto (buff: 1)
sendto (buff: 2)
sendto (buff: 3)
sendto (buff: 4)

- nlink_123 & nlink_456 - netlink example. got from internet.

- nlink_789 netlink example

use chainX_api.c (CHAINX_MODE_ID_NETLINK).

AF_NETLINK 的操作

$ ./nlink_789
[9442/9443] chainX_netlink_bind:2094 - bind ... (AF_NETLINK)
[9442/9443] chainX_thread_handler_netlink:3415 - netlink-bind ok !!! (netlink, dbg: 4, net_status: 1, sockfd: 3, net_security: 0)
[9442/9443] netlink_recv:34 - Got !!! (ifname: lo, index: 1, status: UP)
[9442/9443] netlink_recv:34 - Got !!! (ifname: enp0s3, index: 2, status: UP)
[9442/9443] netlink_recv:34 - Got !!! (ifname: enp0s8, index: 3, status: UP)
[9442/9443] netlink_recv:34 - Got !!! (ifname: enp0s9, index: 4, status: UP)
[9442/9443] netlink_recv:34 - Got !!! (ifname: docker0, index: 5, status: DOWN)

- onvif_client_123 - onvif client example.

export PJ_HAS_MXML=yes, use onvif_api.c.

請記得參考 helper_ONVIF.md，理論上很簡單，curl 可以幫助理解。

$ ./onvif_client_123

- ping_123 - ping example.

use chainX_api.c.

$ ./ping_123 -i 1 -c 3 google.com
[35736/35736] chainX_ping:3691 - sockfd error !!! (errno: 1 Operation not permitted)
[35736/35736] main:109 - (count: 0/3)

$ sudo ./ping_123 -i 1 -c 3 google.com
[sudo] password for lanka:
[35735/35735] chainX_icmp:3560 - PING google.com (): 64 bytes of data
[35735/35735] chainX_icmp:3633 - 64 bytes from tsa01s11-in-f14.1e100.net (): icmp_seq=1 ttl=64 time=13.98 ms
[35735/35735] chainX_icmp:3633 - 64 bytes from tsa01s11-in-f14.1e100.net (): icmp_seq=2 ttl=64 time=9.32 ms
[35735/35735] chainX_icmp:3633 - 64 bytes from tsa01s11-in-f14.1e100.net (): icmp_seq=3 ttl=64 time=9.45 ms
[35735/35735] chainX_icmp:3668 - --- google.com ping statistics ---
[35735/35735] chainX_icmp:3669 - 3 packets transmitted, 3 received, 0% packet loss, time: 33 ms.
[35735/35735] main:109 - (count: 3/3)

- proc_list_123 & proc_watch - a system and proc information example.

- queuex_123 - a queue example.

use queuex_api.c.

這是一個 queue + exec 的範例。建立一個 queue 對於軟體工程師不是很艱難的事情，但是東西放入後，要有續的處理就不是每位軟體工程師能處理的。

$ ./queuex_123
[8651/8651] test_push:62 - (idx: 0)
[8651/8651] queuex_push:311 - (name: test, length: 0/30, ishold: 0, isloop: 1)
[8651/8651] test_push:62 - (idx: 1)
[8651/8651] queuex_push:311 - (name: test, length: 1/30, ishold: 0, isloop: 1)
[8651/8651] test_push:62 - (idx: 2)
[8651/8651] queuex_push:311 - (name: test, length: 2/30, ishold: 0, isloop: 1)
[8651/8651] test_push:62 - (idx: 3)
[8651/8651] queuex_push:311 - (name: test, length: 3/30, ishold: 0, isloop: 1)
[8651/8651] test_push:62 - (idx: 4)
[8651/8651] queuex_push:311 - (name: test, length: 4/30, ishold: 0, isloop: 1)
[8651/8652] test_q_exec_cb:38 - (data_pop->idx: 0)
[8651/8652] test_q_exec_cb:38 - (data_pop->idx: 1)
[8651/8652] test_q_exec_cb:38 - (data_pop->idx: 2)
[8651/8652] test_q_exec_cb:38 - (data_pop->idx: 3)
[8651/8652] test_q_exec_cb:38 - (data_pop->idx: 4)

- select_123 - select example.

Call select instead of sleep

SAFE_SELECT_EX(0, NULL, NULL, NULL, interval/1000, interval%1000);

$ ./select_123
[373204/373204] app_loop:49 - (TAG: select_123, pid: 373204)
[373204/373204] app_loop:56 - duration: 60, usleep(1000) ...
[373204/373204] main:182 - Bye-Bye !!!

- sshX_123 - ssh example.

export PJ_HAS_LIBSSH=yes, use ssh_api.c.

- statex_123 - state machine example.

use statex_api.c.

一般人都會用 switch - case 實作 state machine，常會發生跳離目前的狀態後，忘了處理後續狀態，造成程式就此停擺。

例如辨別是否連上線，有以下狀態

A. wifi 找到 ssid

B. wifi 連上 ssid

C. 要到了 IP

D. ping 8.8.8.8

E. ping 8.8.8.8 ok

當已連線的狀態下突然失敗時，一般軟體工程師的處理有可能就直接刷新、有的會直接選某個狀態進行測試，不知這些動作或許可以解決問題，但不知原本的程序是否還在進行或某些 Magic Flag 忘了清除 ，反而會造成整個系統混亂。

$ ./statex_123
[8842/8843] sys_init2_cb:19 - __________ Enter __________
[8842/8843] sys_enter2_cb:31 - __________ Enter __________
[8842/8843] sys_init0_cb:53 - __________ Enter __________
[8842/8843] sys_leave2_cb:27 - __________ Enter __________
[8842/8843] sys_enter0_cb:65 - __________ Enter __________
[8842/8843] sys_init1_cb:36 - __________ Enter __________
[8842/8842] sys_free0_cb:57 - __________ Enter __________
[8842/8842] sys_free1_cb:40 - __________ Enter __________
[8842/8842] sys_free2_cb:23 - __________ Enter __________

- swlink_123 - swconfig example. (depend on linux kernel)

- thread_123 - thread example.

use thread_api.c.

啟動 2 * threads

thread_A，執行 MAX_OF_A+1 次

thread_B，執行 MAX_OF_B+1 次

$ ./thread_123
[372895/372897] thread_handler:29 - Run loop ... (name: thread_B, count: 0)
[372895/372897] thread_handler:46 - (name: thread_B, count: 0/15)
[372895/372896] thread_handler:29 - Run loop ... (name: thread_A, count: 0)
[372895/372896] thread_handler:37 - (name: thread_A, count: 0/5)
[372895/372897] thread_handler:46 - (name: thread_B, count: 1/15)
[372895/372896] thread_handler:37 - (name: thread_A, count: 1/5)
[372895/372897] thread_handler:46 - (name: thread_B, count: 2/15)
[372895/372896] thread_handler:37 - (name: thread_A, count: 2/5)
[372895/372897] thread_handler:46 - (name: thread_B, count: 3/15)
[372895/372896] thread_handler:37 - (name: thread_A, count: 3/5)
[372895/372897] thread_handler:46 - (name: thread_B, count: 4/15)
[372895/372896] thread_handler:37 - (name: thread_A, count: 4/5)
[372895/372897] thread_handler:46 - (name: thread_B, count: 5/15)
[372895/372896] thread_handler:37 - (name: thread_A, count: 5/5)
[372895/372896] thread_handler:40 - (tidx_req: 0x560cfbf0f120, &tidx_data_A: 0x560cfbf0f120)
[372895/372896] thread_handler:68 - Bye-Bye !!! (name: thread_A)
[372895/372897] thread_handler:46 - (name: thread_B, count: 6/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 7/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 8/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 9/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 10/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 11/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 12/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 13/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 14/15)
[372895/372897] thread_handler:46 - (name: thread_B, count: 15/15)
[372895/372897] thread_handler:49 - (tidx_req: 0x560cfbf0f040, &tidx_data_B: 0x560cfbf0f040)
[372895/372897] thread_handler:68 - Bye-Bye !!! (name: thread_B)
[372895/372895] main:93 - Bye-Bye !!!

- tty_123 - a tty example.

use chainX_api.c.

tty 的連線程式

$ ./tty_123 -t /dev/ttyS0 -b 57600n8

- tunnel_123 - ssh tunnel example.

export PJ_HAS_LIBSSH=yes, use ssh_api.c.

- ubox_123 - ubox example.

export PJ_HAS_LIBUBOX=yes,.

操控 libubox

- ubus_123 - ubus example.

export PJ_HAS_UBUS=yes, use ubus_api.c.

操控 ubus (OpenWrt micro bus architecture)

- uci_123 - uci example.

export PJ_HAS_UCI=yes, use uci_api.c.

操控 OpenWrt UCI (Unified Configuration Interface)

- usb_123 - usb example.

export PJ_HAS_LIBUSB=yes, use usbX_api.c.

監聽 usb 插拔

以下為 ID 10C4:8468 Tiqiaa

#define VENDOR_ID 0x10C4 #define PRODUCT_ID 0x8468

$ ./usb_123
[433457/433459] usbX_thread_handler:677 - usbX listen ... (vendor_id: 0x000010C4, product_id: 0x00008468)
^C[433457/433457] app_signal_handler:260 - (signum: 2)
[433457/433457] app_stop:207 - Bye-Bye !!! (usb_123)
[433457/433459] usbX_thread_handler:719 - Bye-Bye !!!
[433457/433457] main:349 - Bye-Bye !!!

- util_123 - example.

$ ./util_123
[8946/8946] main:23 - (Version: 0x03000000, 2922, 1710208772, lanka, 1710379668)
[8946/8946] main:26 - (Debug LVL: 2, Expiration: 1861919999=20290101 075959, Time Diff: 1753.94)
[8946/8946] main:27 - (Toolchain: , Path: , Build Path: /work/codebase/lankahsu520/utilx9)
[8946/8946] main:28 - (Name: github, Platform: linux, Save: /work/IoT, Work: /tmp/IoT)
[8946/8946] main:29 - (ICLOUD: 192.168.50.148:9000-0, IFACE: enp0s8)
[8946/8946] main:30 - (MCTT: 229.255.255.250:6288)
[8946/8946] main:34 - BIT_SET(num,0) (num: 0x00000001)
[8946/8946] main:36 - BIT_SET(num,2) (num: 0x00000005)
[8946/8946] main:38 - BIT_SET(num,4) (num: 0x00000015)
[8946/8946] main:40 - BIT_SET(num,6) (num: 0x00000055)
[8946/8946] main:42 - BIT_SET(num,8) (num: 0x00000155)
[8946/8946] main:44 - BIT_INVERSE(num,3) (num: 0x0000015D, num.bit2: 1, num.bit3: 1)

- uv_000 - uv template.

export PJ_HAS_LIBUV=yes, use uv_api.c.

$ ./uv_000
[8948/8948] timer_1sec_loop:40 - kick async every 1 second. (countdown: 2)
[8948/8948] async_loop:98 - __________ Enter __________
[8948/8948] async_loop:104 - (*data: 1)
[8948/8948] timer_1sec_loop:40 - kick async every 1 second. (countdown: 1)
[8948/8948] async_loop:98 - __________ Enter __________
[8948/8948] async_loop:104 - (*data: 2)
[8948/8948] timer_1sec_loop:40 - kick async every 1 second. (countdown: 0)
[8948/8948] main:255 - Bye-Bye !!!

- uv_123 - uv example.

export PJ_HAS_LIBUV=yes, use uv_api.c.

$ ./uv_123
[428761/428762] thread_loop:87 - (count: 1)
[428761/428764] queue_work_handler:123 - (id: 1, count: 1)
[428761/428764] queue_work_handler:123 - (id: 2, count: 1)
[428761/428764] queue_work_handler:123 - (id: 3, count: 1)
[428761/428764] queue_work_handler:123 - (id: 4, count: 1)
[428761/428764] queue_work_handler:123 - (id: 5, count: 1)
[428761/428764] queue_work_handler:123 - (id: 6, count: 1)
[428761/428764] queue_work_handler:123 - (id: 7, count: 1)
[428761/428764] queue_work_handler:123 - (id: 8, count: 1)
[428761/428764] queue_work_handler:123 - (id: 9, count: 1)
[428761/428764] queue_work_handler:123 - (id: 10, count: 1)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 1, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 2, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 3, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 4, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 5, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 6, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 7, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 8, status: 0)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 9, status: 0)
[428761/428761] async_loop:304 - (percentage: 1)
[428761/428761] queue_work_finisher:113 - Bye-Bye !!! (id: 10, status: 0)
[428761/428762] thread_loop:87 - (count: 2)
[428761/428761] async_loop:304 - (percentage: 2)
[428761/428762] thread_loop:87 - (count: 3)
[428761/428761] async_loop:304 - (percentage: 3)
[428761/428762] thread_loop:87 - (count: 4)
[428761/428761] async_loop:304 - (percentage: 4)
[428761/428762] thread_loop:87 - (count: 5)
[428761/428761] async_loop:304 - (percentage: 5)
[428761/428762] thread_loop:87 - (count: 6)
[428761/428761] async_loop:304 - (percentage: 6)
[428761/428762] thread_loop:87 - (count: 7)
[428761/428761] async_loop:304 - (percentage: 7)
[428761/428762] thread_loop:87 - (count: 8)
[428761/428761] async_loop:304 - (percentage: 8)
[428761/428762] thread_loop:87 - (count: 9)
[428761/428761] async_loop:304 - (percentage: 9)
[428761/428762] thread_loop:87 - (count: 10)
[428761/428761] async_loop:304 - (percentage: 10)
[428761/428761] timer_1_loop:53 - (count: 1)
[428761/428762] thread_loop:101 - Bye-Bye !!! (uv_123)
[428761/428761] timer_1_loop:59 - Bye-Bye !!!
[428761/428761] timer_2_loop:67 - (count: 1)
[428761/428761] timer_2_loop:72 - Bye-Bye !!!
[428761/428761] main:514 - Bye-Bye !!!

- uv_spawn_123 - uv spawn example.

export PJ_HAS_LIBUV=yes, use uv_api.c.

程式啟動後，第2秒使用 uv_spawn_open_ex 執行 ping 8.8.8.8，並且接收 stdout；

程式每 3秒使用 uv_spawn_simple_detached 啟動 uv_123。( 因為 uv_123 是 UV_PROCESS_DETACHED，程式結束後記得 killall uv_123 )

$ ./uv_spawn_123
[4179/4179] timer_1sec_loop:94 - (count: 1)
[4179/4179] timer_1sec_loop:94 - (count: 2)
[4179/4179] uv_spawn_open_ex:163 - Launch a new thread !!! (spawn_req: 0x55c5898c72e0, pid: 4180)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
64 bytes from 8.8.8.8: icmp_seq=1 ttl=117 time=3.58 ms
)
[4179/4179] timer_1sec_loop:94 - (count: 3)
[4179/4179] uv_spawn_simple_detached:214 - uv_spawn ... (child_args[0]: ./uv_123)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: 64 bytes from 8.8.8.8: icmp_seq=2 ttl=117 time=3.56 ms
)
[4179/4179] timer_1sec_loop:94 - (count: 4)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: 64 bytes from 8.8.8.8: icmp_seq=3 ttl=117 time=3.97 ms
)
[4179/4179] timer_1sec_loop:94 - (count: 5)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: 64 bytes from 8.8.8.8: icmp_seq=4 ttl=117 time=3.68 ms
)
[4179/4179] timer_1sec_loop:94 - (count: 6)
[4179/4179] uv_spawn_simple_detached:214 - uv_spawn ... (child_args[0]: ./uv_123)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: 64 bytes from 8.8.8.8: icmp_seq=5 ttl=117 time=5.61 ms
)
[4179/4179] timer_1sec_loop:94 - (count: 7)
[4179/4179] uv_spawn_pipe_stdout_cb:119 - (buf->base: 64 bytes from 8.8.8.8: icmp_seq=6 ttl=117 time=3.39 ms
)
^C[4179/4179] app_signal_handler:241 - (signum: 2)
[4179/4179] async_loop:178 - (async_count: 1)
[4179/4179] app_stop_uv:144 - call SAFE_UV_TIMER_CLOSE ~~~
[4179/4179] app_stop_uv:149 - call uv_spawn_close_ex ~~~
[4179/4179] app_stop_uv:154 - call SAFE_UV_CLOSE ~~~
[4179/4179] app_stop_uv:160 - call SAFE_UV_LOOP_CLOSE ~~~
[4179/4179] app_stop_uv:167 - exit
[4179/4179] uv_spawn_exit_cb:79 - Bye-Bye !!! (ping)
[4179/4179] main:328 - Bye-Bye !!!

- wsdiscovery_123 - WS-Discovery example.

export PJ_HAS_MXML=yes, use wsdiscovery_api.c.

$ ./wsdiscovery_123

- gbusx_123 - a example.

use gbusx_api.c.

6. License

utilx9 is under the New BSD License (BSD-3-Clause).

7. Documentation

Run an example and read it.