posta - Amiga Magazine Online

essere assoluto, cioè deve comprendere tutto il path a
partire dalla radice del file system cui viene inviato (non
sono ammesse le directory logiche, quelle generate con
Assign). I1 motivo è molto semplice: si può chiedere la
notifica anche di un file che ancora non esiste. Verremo
awertiti quando il file sarà creato. Inoltre, la notifica conti-
nua a sussistere anche quando il file viene cancellato. Non
solo, ma potrebbe anche non esistere (o essere cancellata)
la directory che contiene il file. Per questo, l'handler ha
bisogno di conoscere tutto il path del file e non solo il nome
relativo a una determinata directory come avviene di solito
con altri pacchetti del DOS.
I1 campo nr-UserData è a completa disposizione dell'appli-
cativo, che lo può usare per tenerci dei dati o l'indirizzo di
una funzione da lanciare nel momento in cui riceverà la
notifica.
I1 campo nr-Flags serve ad indicare all'handler quale meto-
do deve utilizzare per effettuare la notifica. I flag possibili
sono seguenti:
NRF-SENDMESSAGE (1): richiede l'uso di un messaggio
Exec come metodo di notifica.
NRF-SEND-SIGNAL (2): richiede un semplice segnale
Exec per la notifica. E' ovviamente alternativo al primo.
NRF-WAIT-REPLY (8): ha significato in congiunzione
con NRF-SENDMESSAGE; indica all'handler di attendere
la replica al messaggio precedente prima di inviare un
nuovo messaggio.
NRF_NOTII;Y-INITIAL (16): indica all'handler di notifi-
care il programma chiamante se il file esiste nel momento
in cui si richiede la notifica (il che significa che la prima
notifica ricevuta non segnala necessariamente una modifi-
cazione del file, ma semplicemente la sua esistenza).
L'interpretazione dell'union successiva dipende dal rneto-
do prescelto per la notifica: se è stato scelto il metodo con
i messaggi, allora nr-stuff.nr-Msg.nr-Port deve contenere
l'indirizzo della MsgPort del programma chiamante cui
l'handler invierà i messaggi. Se invece si sono preferiti i
segnali, nr-stuff.nr-Signal.nrPTask dovrà contenere l'indi-
rizzo della struttura Task del programma chiamante e
nr-stuff.nr-Signal.SignaiNum il numero del segnale da
usare. in pratica, ammesso che nr sia l'indirizzo della
struttura NotifyRequest I'handler farà:
PutMsg(nr->nr-stuff.nrMsg.nr-Port, messaggio)
nel primo caso e:
nel secondo.
struct NotifyMessage {
struct Message nm-ExecMessage; /* il solito
messaggio Exec */
ULONG nmpClass;
UWORD nm-Code;
struct NotifyRequest *nm-NReq; /* non
modificare */
ULONG nm-DoNotTouch; /* Riservato
all'handler */
ULONG nm-DoNotTouch2; / * Riservato
all' handler */
};
Figura 2: La struttura del messaggio inviato
dali'handler: è definita nel file include dos/noti€y.h
Il resto della struttura è riservato a sviluppi futuri, alle
funzioni di gestione della notifica o all'handler.
Se si sceglie il metodo dei messaggi, alla porta indicata
arriveranno dei messaggi che corrispondono alla struttura
NotifyMessage descritta in figura 2. I suoi campi hanno
poca importanza e, fra l'altro, non sono molto documentati.
Dopo la classica struttura Message di Exec compaiono due
campi, il cui valore, impostato dall'handler, dovrebbe esse-
re NOTIFY-CLASS (0x40000000) per nm-Class e
NOTIFY-CODE (0x1234) per nm-Code.
Non so a cosa facciano riferimento e i file include avvertono
che il loro uso è scoraggiato e che potrebbero cambiare in
futuro. Più utile è il campo nm-NReq che è un puntatore
alla struttura NotifyRequest utilizzata per awiare la notifica.
Gli altri campi sono riservati all'handler. Si ricordi che la
memoria del messaggio è proprietà dell'handler e non sta
al programma utente allocarla e disallocarla (come è invece
il caso per NotifyRequest).
Le funzioni
Abbiamo visto finora il funzionamento della notifica a
livello di pacchetti. Ma, come al solito, il DOS mette a
disposizione delle funzioni per evitare di ricorrere diretta-
mente ai pacchetti e aiutare il programmatore. Per awiare
una notifica, si potrà usare la funzione StartNotify( ) che
richiede come unico parametro una struttura NotifyRe-
quest inizializzata e ritorna un valore booleano. Quando si
usa questa funzione non si deve usare il campo
nr-FullName, bensì nr-Name.
In questo campo non andrà necessariamente il nome asso-
luto del file che vogliamo monitorare, come in
nr-FullName, ma potremo inserirvi anche nomi che con-
tengono directory logiche e nomi relativi alla directory
corrente del nostro processo; la funzione convertirà, per
noi, tale nome in un nome assoluto e ne inserirà il valore in