execrom.8 (3526B)
1 .Dd 6 de setembre de 2025 2 .Dt EXECROM 8 3 .Os 4 .Sh NOM 5 .Nm execrom 6 .Nd Executar ROMs 7 .Sh SINOPSI 8 .Ar ROM 9 .Op Ar argument ... 10 .Sh DESCRIPCIÓ 11 Quan és executada, 12 la utilitat 13 .Nm execrom 14 inspecciona el seu argument 0, 15 que ha de contenir 16 .Ar ROM , 17 el nom amb el qual ha estat invocat. 18 Recórre després les carpetes enumerades dins 19 .Dv EXECROM_CHEM 20 amb l’objectiu de trobar un fitxer 21 el prefix de qual correspongui a 22 .Ar ROM 23 seguit d’un punt (« . »). 24 Atura la cerca 25 quan troba un fitxer apropiat, 26 i executa el programa el nom del qual correspongui 27 al sufix d’aquest fitxer, 28 donant-li 29 .Ar ROM 30 i 31 .Op Ar argument ... 32 com a arguments. 33 .Pp 34 Així, 35 els noms dels programes 36 accessibles mitjançant 37 .Ev EXECROM_CHEM 38 tenen la forma 39 .Em nom.interpretador . 40 .Em nom 41 és el nom del programa per interpretar. 42 Per ser escollit, 43 ha de ser igual a 44 .Ar ROM . 45 .Em interpretador 46 és el nom de l’executable 47 destinat a interpretar el programa. 48 Aquest executable ha d’estar 49 accessible mitjançant 50 .Dv PATH . 51 .Pp 52 .Nm 53 no s’ha concebut per ser executat directament, 54 sinó a través d’un enllaç simbòlic apuntant cap a ell. 55 .Sh ENVIRONNEMENT 56 La variable d’entorn següent influencia l’execució d’\c 57 .Nm . 58 .Bl -tag -width "EXECROM_CHEM" 59 .It Ev EXECROM_CHEM 60 Llista de camins, 61 apartats per dos punts (« : »), 62 cap a les carpetes 63 que reuneixen els programes per interpretar. 64 Te la mateixa estructura que 65 .Ev PATH . 66 .El 67 .Sh EXEMPLE 68 Siguin 69 .Pa ~/uxn/drifblim 70 i 71 .Pa ~/uxn/left 72 dues ROMs executables 73 per una màquina Varvara. 74 La primera conté un assemblador uxntal 75 interpretable per la màquina virtual en mode de text 76 .Xr uxncli 1 . 77 L’ordre següent assembla 78 .Pa prog.tal 79 dins 80 .Pa prog.rom . 81 .Bd -literal -offset indent 82 $ uxncli ~/uxn/drifblim prog.tal prog.rom 83 .Ed 84 .Pp 85 La segona ROM és un editor de text en mode gràfic. 86 Per tant, l’ha d’interpretar 87 .Xr uxnemu 1 . 88 L’ordre següent obre el fitxer 89 .Pa doc.txt 90 amb l’editor de text. 91 .Bd -literal -offset indent 92 $ uxnemu ~/uxn/left doc.txt 93 .Ed 94 .Pp 95 Gràcies a 96 .Nm , 97 és possible iniciar aquests dos programes 98 sense haver d’especificar cada cop l’interpretador adient 99 i el camí cap a la ROM. 100 Per configurar-ho, 101 cal establir la variable d’entorn 102 .Dv EXECROM_CHEM 103 de tal manera que contingui 104 el camí cap a les carpetes 105 on resideixen les ROMs, 106 aquí, 107 .Pa ~/uxn. 108 .Bd -literal -offset indent 109 $ export EXECROM_CHEM="$HOME/uxn:$EXECROM_CHEM" 110 .Ed 111 .Pp 112 També cal modificar el nom de cada ROM 113 de tal manera que el seu prefix i el seu sufix corresponguin 114 al seu nom d’invocació i 115 al nom del programa destinat a interpretar-lo, 116 respectivament. 117 El resultat hauria de ser semblant a: 118 .Bd -literal -offset indent 119 $ ls ~/uxn 120 drifblim.uxncli 121 left.uxnemu 122 .Ed 123 .Pp 124 Per fi, 125 per cada ROM 126 s’ha de crear 127 un enllanç simbólic accessible mitjançant 128 .Dv PATH 129 i apuntant cap a l’executable d’\c 130 .Nm . 131 .Bd -literal -offset indent 132 $ ln -s /usr/local/libexec/execrom ~/.local/bin/driftblim 133 $ ln -s /usr/local/libexec/execrom ~/.local/bin/left 134 .Ed 135 .Pp 136 Les ROMs ara es poden executar directament. 137 .Bd -literal -offset indent 138 $ drifblim prog.tal prog 139 $ left doc.txt 140 .Ed 141 .Sh ESTAT DE SORTIDA 142 La utilitat 143 .Nm execrom 144 surt amb 0 si tot ha anat bé i amb >0 si un error ha ocurregut. 145 .Sh AUTORS 146 .An Loïc Daignault-Pichette <ldp@asteride.xyz> 147 .Sh TRADUCCIÓ 148 Aquesta pàgina del manual 149 va ser traduïda 150 per primera vegada 151 de la seva versió original en francès 152 per 153 .An Loïc Daignault-Pichette <ldp@asteride.xyz> 154 al mes de setembre de 2025 155 i està actualitzada amb la versió 1.0 de la utilitat.