Descrizione del componente OPKG

Il gestore di pacchetti opkg è progettato per estendere le funzionalità dei dispositivi Keenetic installando pacchetti software aggiuntivi. Utilizzando opkg, gli utenti esperti possono installare e aggiornare moduli non inclusi nel firmware di base del dispositivo, consentendo loro di configurare in modo flessibile le funzionalità del router per attività specifiche.

Questo articolo descrive i principi di utilizzo di opkg in KeeneticOS, inclusa la procedura di installazione, i metodi per la connessione di dispositivi di archiviazione esterni e le raccomandazioni per l'utilizzo dei pacchetti dal repository.

Il componente Supporto pacchetti aperti deve essere installato sul dispositivo per utilizzare i pacchetti aperti.

Il componente:

aggiunge i comandi di configurazione di opkg,
monta un filesystem USB in /opt,
espande i file *.ipk e *.tar.gz dalla directory /opt/install,
esegue gli script hook.

Configurazione

Il comando opkg disk viene utilizzato per specificare il filesystem /opt. Il filesystem può essere identificato tramite UUID o etichetta di volume. Ad esempio,

(config)> opkg disk OPT_LABEL:
Opkg::Manager: Disk is set to: OPT_LABEL.
(config)> system configuration save

Sono supportati i file system NTFS e EXT2/3. Una volta configurato il opkg disk e collegato l'archivio, il componente opkg:

Monta il filesystem OPT_LABEL in /opt.
Se la directory /opt/install esiste, espande tutti i file /opt/install/*.ipk in /opt. Questa decompressione dovrebbe essere completata in 120 secondi o verrà terminata per timeout.
Esegue /opt/etc/initrc.

Script hook

Gli script hook si trovano in:

/opt/etc/initrc — script di avvio predefinito (può essere definito tramite il comando opkg initrc),
/opt/etc/ndm/*.d/ — gestori di eventi.

Le directory degli script e le variabili d'ambiente sono descritte nelle sezioni specifiche di seguito.

Le variabili PATH e LD_LIBRARY_PATH sono predefinite per la selezione di eseguibili e librerie dinamiche da /opt:

PATH=/opt/bin:/opt/sbin:/opt/usr/bin:/opt/usr/sbin:/bin:/sbin:/usr/bin:/usr/sbin
LD_LIBRARY_PATH=/opt/lib:/opt/usr/lib:/lib:/usr/lib

Il prefisso /opt è sempre implicito nello shebang dello script hook. Cioè, sia #!/bin/sh che #!/opt/bin/sh eseguiranno l'interprete /opt/bin/sh.

C'è un timeout di 24 secondi su ogni script da eseguire.

Tutti gli script hook vengono avviati in un'unica coda, ovvero mentre /opt/etc/ndm/wan.d/01-one.sh è ancora in esecuzione, nessun altro script verrà avviato né da /opt/etc/ndm/wan.d/ né da /opt/etc/ndm/netfilter.d/.

initrc

Lo script di inizializzazione /opt/etc/initrc viene eseguito dopo il montaggio di /opt. Può eseguire altri script di inizializzazione, come /opt/etc/init.d/* per avviare processi in background. Se /opt/etc/initrc è mancante, il componente OPKG eseguirà /opt/etc/init.d/* in ordine alfabetico.

Ad esempio, lo script di avvio di dropbear potrebbe essere:

#!/bin/sh

if [ ! -d /opt/etc/dropbear ]; then
    mkdir /opt/etc/dropbear
fi

if [ ! -f /opt/etc/dropbear/dropbear_dss_host_key ]; then
    dropbearkey -t dss -f /opt/etc/dropbear/dropbear_dss_host_key
fi

if [ ! -f /opt/etc/dropbear/dropbear_rsa_host_key ]; then
    dropbearkey -t rsa -f /opt/etc/dropbear/dropbear_rsa_host_key
fi

dropbear

Per renderlo compatibile con i sistemi di inizializzazione di tipo Sys-V, gli script /opt/etc/initrc e /opt/etc/init.d vengono chiamati con l'argomento della riga di comando start. Quando l'utente desidera espellere lo storage /opt, /opt/etc/initrc viene chiamato con l'argomento stop.

ndm/wan.d

Gli script di eventi /opt/etc/ndm/wan.d/ vengono eseguiti quando è disponibile una nuova connessione a Internet.

1° Parametro	Descrizione
`start`	Connessione Internet stabilita
`stop`	Connessione Internet terminata

Variabile	Descrizione
`$interface`	Interfaccia WAN, come `ppp0`
`$address`	Indirizzo IP dell'interfaccia
`$mask`	Maschera di sottorete dell'interfaccia
`$gateway`	Indirizzo IP del gateway WAN

Quando la connessione a Internet non è attiva, gli script wan.d vengono eseguiti con tutte le variabili sopra non definite.

Se la connessione a Internet è stata stabilita prima di montare /opt, gli script wan.d vengono eseguiti subito dopo initrc.

ndm/user.d

Gli script /opt/etc/ndm/user.d vengono eseguiti quando /etc/passwd e /etc/group vengono aggiornati dal sistema principale. Aggiungere script a user.d se è necessario modificare /etc/passwd o /etc/group. In caso contrario, qualsiasi modifica a questi file verrà sovrascritta.

Variabile	Descrizione
`$user`	Nome utente con accesso `OptWare`, se aggiunto tramite il sistema principale

Quando un utente viene eliminato, gli script user.d vengono eseguiti con un $user non definito.

Ad esempio, è possibile creare directory home utilizzando l'hook user.d come segue:

#!/bin/sh

home=/opt/home

[ -z "$user" ] && exit 0       # $user is undefined
[ -d $home/$user ] && exit 0   # home already exists

if mkdir -p $home/$user; then
    chmod 0755 $home
    chmod 0700 $home/$user
    chown $user $home/$user
fi

ndm/netfilter.d

Gli script /opt/etc/ndm/netfilter.d vengono eseguiti quando il sistema riscrive una tabella netfilter. Gli hook netfilter.d possono modificare la tabella usando iptables. Le variabili $table e $type devono essere controllate per evitare la duplicazione delle regole.

Variabile	Descrizione
`$type`	protocollo netfilter, come `iptables` per IPv4 o `ip6tables` per IPv6
`$table`	tabella netfilter, come `filter`, `nat` o `mangle`

Ad esempio, è possibile aggiungere alcune regole mangle come segue:

#!/bin/sh

[ "$type" == "ip6tables" ] && exit 0   # check the protocol type in backward-compatible way
[ "$table" != "mangle" ] && exit 0   # check the table name

iptables -A PREROUTING -i br0 -t mangle -p tcp --dport 22 -j MARK --set-mark 1
iptables -A PREROUTING -i br0 -t mangle -p tcp --dport 23 -j MARK --set-mark 1

ndm/usb.d

Gli script /opt/etc/ndm/usb.d vengono eseguiti quando un dongle USB è collegato o scollegato.

1° Parametro	Descrizione
`start`	Dispositivo USB collegato
`stop`	Dispositivo USB scollegato

Le seguenti variabili d'ambiente sono definite per consentire di identificare il dongle.

Variabile	Descrizione	Esempio
`$usb_device`	Percorso del dispositivo `/proc/bus/usb`	`/proc/bus/usb/002/001`
`$usb_devname`	Nome del dispositivo in `/proc/bus/usb`	`bus/usb/002/001`
`$usb_devpath`	Percorso in sysfs	`/devices/platform/xhci-hcd/usb2`
`$usb_model`	ID modello USB	`0003`
`$usb_port`	Numero porta USB	`2`
`$usb_vendor`	ID fornitore USB	`1d6b`

Qualsiasi dispositivo collegato prima dell'esecuzione dello script di inizializzazione opkg attiverà questi script di richiamo pianificati per essere eseguiti all'esecuzione dello script di inizializzazione OPKG.

ndm/fs.d

Gli script /opt/etc/ndm/fs.d vengono chiamati quando il filesystem viene montato o si prepara a essere smontato o espulso inaspettatamente.

1° Parametro	Descrizione
`start`	Il filesystem è montato
`stop`	Il filesystem si sta preparando per essere smontato o espulso inaspettatamente

Il tipo di filesystem può essere uno qualsiasi tra: VFAT, EXFAT, NTFS, EXT2, EXT3, EXT4 o HFSP.

Variabile	Descrizione	Esempio
`$type`	Tipo di filesystem	`EXT2`
`$name`	ID del filesystem	`583a7335-6ef8-460b-a4c1-43a2e5c70e71:`
`$label`	Etichetta del filesystem / partizione	`SecondPart`
`$directory`	Directory di montaggio del filesystem (percorso assoluto)	`/tmp/mnt/SecondPart`

Qualsiasi filesystem montato prima dell'esecuzione dello script di inizializzazione OPKG attiverà questi script di richiamo, la cui esecuzione è pianificata all'esecuzione dello script di inizializzazione OPKG.

ndm/time.d

Gli script /opt/etc/ndm/time.d vengono chiamati quando l'ora di sistema viene modificata (sincronizzata tramite NTP).

ndm/button.d

Gli script /opt/etc/ndm/button.d vengono chiamati quando è stato premuto il pulsante FN e/o i pulsanti WPS.

Variabile	Descrizione	Esempio
`$button`	Quale pulsante è stato premuto	`WLAN`
`$action`	Tipo di clic	`clic`, `doppio clic` o `pressione prolungata`

È necessario prima configurare alcuni dettagli dall'interfaccia web.

ndm/schedule.d

Gli script /opt/etc/ndm/schedule.d vengono chiamati con eventi pianificati (se le pianificazioni sono definite tramite CLI).

1° Parametro	Descrizione
`start`	Inizio dell'attività pianificata
`stop`	Fine dell'attività pianificata