Formaty plików
Podczas czytania tego rozdziału należ pamiętać o następujących konwencjach stosowanych przy opisywaniu struktury plików:
pliki binarne opisywane są za pomocą struktur z języka C,
znaki specjalne w plikach tekstowych zaznaczone są zgodnie z konwencjami stosowanymi w procedurach printf, scanf, itp. standardowej biblioteki stdio języka C,
zmienne w plikach tekstowych są podkreślone; ilość znaków wartości zmiennej jest równa długości nazwy zmiennej lub jest nieokreślona jeżeli nazwa zmiennej zaczyna się od znaku '%'.
Worklog's set (wl.set).
Worklogs set jest plikiem tekstowym w standardzie ANSII. Plik ten zawsze występuje wraz z katalogiem worklogs/, który zawiera pliki typu worklog. Struktura pliku jest ciągiem rekordów typu:
DD-MM-YYYY\n
Legenda:
DD – dzień,
MM – miesiąc,
YYYY – rok,
Ciąg dat określa z jakich dni pochodzą pliki worklog z katalogu ./worklogs/ (patrz. roz. 4.7.2.Worklog (*.wl)). Data DD-MM-YYYY jest zgodna z formatem zastosowanym w MySQL i można ją bezpośrednio traktować jako zmienną typu DATE.
Worklog (*.wl).
Worklog jest plikiem binarnym stosowanym do przechowywania danych pobranych z układów SCslave. Zawiera ciąg rekordów typu:
struct mach_data {
struct tms time;
unsigned int code;
unsigned int input;
};
Legenda:
time – czas pobrania danych o strukturze:
typedef unsigned char tiny_int;
struct tms
{
tiny_int hour;
tiny_int min;
tiny_int sec;
};
code – identyfikator modułu SCslave,
input – dane pobrane z modułu SCslave.
Poza strukturą pliku worklog ściśle określona jest także jego nazwa, która jest w formacie:
DD-MM-YYYY.wl
Legenda:
DD – dzień,
MM – miesiąc,
YYYY – rok,
Data DD-MM-YYYY określa dzień, z którego pochodzą dane. Format daty jest zgodny z formatem stosowanym w pliku wl.set.
Processlog (*.pl).
Processlog jest plikiem tekstowym w formacie ASCII zawierający log działania programu SCrunner. Zawiera ciąg rekordów typu:
hh:mm:ss DATA:\tcode:%code\tinput:%input\n
hh:mm:ss USER:\t%signal\n
hh:mm:ss ERROR:\t%type:%errno\n
Legenda:
hh – godzina,
mm – minuta,
ss – sekunda,
%code – kod układu SCslave,
%input – binarna reprezentacja danych pobranych z układu SCslave,
%signal – sygnał podany przez użytkownika; możliwe wartości to:
System_on – rozpoczęcie programu,
Transfer_start – rozpoczęcie transferu,
Transfer_end – zakończenie transferu,
System_off – zakończenie programu,
%type – typ błędu; możliwe wartości opisane są w rozdziale 4.3.1.SCrunner.,
%errno – kod błędu; możliwe wartości opisane są w rozdziale 4.3.1.SCrunner.,
Errorlog (error.log).
Errorlog jest plikiem binarnym przechowujący informacje na temat błędów, które wystąpiły podczas działania programu SCrunner (patrz. roz. 4.3.1.SCrunner.). Struktura plików to zbiór rekordów typu:
struct SCerrno { time_t time; int type; int code; };
4.7.5.Katalog transferowy.
Opisane są tutaj pliki i katalogi, które mogą znaleźć się po dokonaniu transferu w katalogu transferowym.
./terror – pusty plik, który oznacza, że podczas transferu zaistniał poważny błąd,
./wl.set – określa pliku worklog, które znajdują się w katalogu worklogs,
./worklogs/ - katalog zawierający pliki worklog i pliki z ich sumami kontrolnymi MD5,
error.log – plik z błędami powstałymi od ostatniego transferu.
komentarze
Copyright © 2008-2010 EPrace oraz autorzy prac.