Zadaniem skryptu jest konwersja danych binarnych na blok liczb szesnastkowych w formacie Action!. Dane muszą być zapisane w jednym bloku programu relokowalnego w standardzie SpartaDOSu X (nagłówek $FFFE). Drugim blokiem jest blok aktualizacji adresów. Jest on niezbędny, jeżeli w pierwszym występują rozkazy procesora w bezwzględnym trybie adresowania z odwołaniami do lokalizacji w tymże bloku. Obsługiwane są pliki zawierające maksymalnie po jednym bloku: relokowalnym i jednym aktualizacji adresów. W innych przypadkach działanie będzie niepoprawne.

Skrypt został napisany w bashu i wykorzystuje specyficzne cechy tej powłoki oraz wymaga standardowych programów z rodzin Uniksa i GNU takich, jak: awk (mawk lub gawk), xxd czy fold, oraz programu chkxex, napisanego przez kolegę TeBe i rozwijanego przez kolegę Mono. Chkxex powinien być skompilowany przy użyciu kompilatora obsługującego dialekt Delphi, np. Free Pascal Compiler z opcją -Mdelphi.

Wywołanie bez parametrów wyświetli informację o sposobie używania. Przyjmowane parametry:

• nazwa pliku z opcjonalnym przełącznikiem „–f”,

• „-n” – tytuł bloku danych, umieszczany bezpośrednio nad nim (np. deklaracja procedury bądź funkcji lub komentarz),

• „-l” – maksymalna długość wiersza, domyślnie 37; może być również określona zmienną środowiskową LINELEN.

Uwaga: przełącznik „-l” ma pierwszeństwo przed zmienną LINELEN, tzn. w przypadku wystąpienia obydwu tych rzeczy pod uwagę będzie brana wartość opcji „-l”.

Dane wyjściowe zapisywane są na standardowe wyjście, co pozwala na zapis do pliki, jak i dalsze przetwarzanie potokowe. Komunikaty błędów wyprowadzane są na standardowe wyjście błędów. Skrypt zwraca status wykonania:

• 0 – działanie zakończone bez błędów,

• 3 – wyświetlono sposób użycia,

• 4 – wskazany plik jest niedostępny, np. nie istnieje,

• 5 – nieprawidłowy nagłówek bloku,

• 6 – program chkxex uległ awarii,

• 7 – natrafiono na nieprawidłowe dane.

Przykłady:

1. Standardowe użycie: