home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / ttrxid14.lha / TrapTrxID.doc.italiano < prev   
Text File  |  1993-04-07  |  10KB  |  277 lines
  1.  
  2.  
  3.                \\\\\\\\\\\\\\\\\\\\////////////////////
  4.                               TrapTrxID
  5.                                  v1.4
  6.                           Time Synchronizer
  7.  
  8.                             Manuale Utente
  9.  
  10.                                   di
  11.                            Giuseppe Vicari
  12.                        2:331/105.4@Fidonet.Org
  13.                ////////////////////\\\\\\\\\\\\\\\\\\\\
  14.  
  15.  
  16.  
  17.  
  18. ****    Indice                                                   Linea
  19.  
  20.       . Che cos'e`?                                                 38
  21.       . A che cosa serve?                                           47
  22.       . Perche` usare TrapTrxID?                                    57
  23.       . Come si usa?                                                83
  24.       . Note particolari riguardanti TrapDoor?                     129
  25.       . Come funziona?                                             142
  26.       . Bug e problemi?                                            171
  27.       . Come contattare l'autore in caso di problemi?              185
  28.       . La storia di TrapTrxID?                                    193
  29.       . Quanto costa il programma?                                 232
  30.       . Chi bisogna ringraziare?                                   250
  31.       . Come assicurarsi dell'originalita` del programma?          264
  32.       . Fine del documento                                         276
  33.  
  34.  
  35. ****    Fine dell'indice
  36.  
  37.  
  38. >>>>    Che cos'e`?
  39.  
  40.     TrapTrxID  e`  un piccolo tool costruito per TrapDoor che permette
  41. di  sincronizzare  l'orologio  di sistema, utilizzando le informazioni
  42. che  si  trovano  nel file log di TrapDoor.  Tali informazioni vengono
  43. generate  durante  un collegamento di tipo EMSI con il nodo con cui ci
  44. si vuole sincronizzare.
  45.  
  46.  
  47. >>>>    A che cosa serve?
  48.  
  49.     Alcuni  nodi  possono  avere  l'ora di sistema sincronizzata con i
  50. "famosi"  orologi  atomici  per mezzo di apparecchiature particolari o
  51. tramite  collegamento  con  altri  nodi.   In questo modo, utilizzando
  52. TrapTrxID,  potrai  sempre  avere  il  tuo  orologio regolato sull'ora
  53. esatta.   Per  fare  questo  ci si collega al nodo con cui ci si vuole
  54. sincronizzare con TrapDoor e poi si lancia TrapTrxID.
  55.  
  56.  
  57. >>>>    Perche` usare TrapTrxID?
  58.  
  59.     Questo  programma,  rispetto a quelli gia` esistenti, offre alcuni
  60. vantaggi:
  61.  
  62.     1. E`  stato  concepito  per essere il piu` corto e il piu` veloce
  63.        programma sulla faccia della terra ;-)
  64.  
  65.     2. Analizza  completamente il file di log evitando di perdere dati
  66.        qualora   l'ultima  sessione  fosse  risultata  particolarmente
  67.        lunga.
  68.  
  69.     3. Informa  il  sistema,  scrivendo  una  linea nel file di log di
  70.        TrapDoor, dell'avvenuta sincronizzazione.
  71.  
  72.     4. Utilizzando  la  riga  inserita  nel  file  di  log,  evita  di
  73.        risincronizzare  l'ora  di sistema se si riesegue piu` volte il
  74.        programma.
  75.  
  76.     5. Possibilita` di sincronizzare l'orologio interno.
  77.  
  78.     6. E`  di tipo PURE, quindi puo` essere reso residente.  In questo
  79.        modo  e`  possibile lanciarlo piu` volte senza doverlo caricare
  80.        ogni volta dall'unita` di massa.
  81.  
  82.  
  83. >>>>    Come si usa?
  84.  
  85.     TrapTrxID  si puo` usare in due modi:  puo` essere eseguito da CLI
  86. o   da   un   particolare   file   script   (ad  es.   User-StartUp  o
  87. StartUp-Sequence);  il secondo modo consiste nel lanciare TrapTrxID al
  88. termine  di  una  sessione  EMSI:   in questo modo la sincronizzazione
  89. avviene  ad ogni sessione.  Questa possibilita e` offerta dall'opzione
  90. AFTERSESSION  di  TrapDoor  (cfr.   documenti allegati al pacchetto di
  91. TrapDoor).
  92.  
  93.     I parametri da passare a TrapTrxID sono cinque:
  94.  
  95. 1)  il nome completo del file di log di TrapDoor, comprensivo del path
  96.     per raggiungere il file (parametro obbligatorio).
  97.  
  98. 2)  il numero del nodo con cui ci si vuole sincronizzare.  Qualora non
  99.     si  specifichi  questo parametro, la sincronizzazione avverra' con
  100.     l'ultimo nodo con cui si e` avuta una sessione EMSI.
  101.  
  102. 3)  le dimensioni del buffer interno.
  103.  
  104. 4)  il flag ASK se si vuole che TrapTrxID chieda una conferma prima di
  105.     settare l'ora.
  106.  
  107. 5)  il flag SET se si vuole sincronizzare anche l'orologio interno.
  108.  
  109.     Questa e' la stringa del parser:
  110.  
  111. "LOGNAME/A,NODE,ASK/S,SET/S,BUFFER/N".
  112.  
  113.     Esempio (da CLI):
  114.  
  115. TrapTrxID Mail:Logs/TrapDoor.log 2:333/100.0
  116.  
  117.     Inserire questa stringa in un file di script o usarla per lanciare
  118. TrapTrxID da CLI.
  119.  
  120.     Esempio (da TrapDoor):
  121.  
  122. AFTERSESSION "TrapTrxID %l 2:333/100.0"
  123.  
  124.     Inserire  questa  stringa  nel file di configurazione di TrapDoor.
  125. La stringa %l viene sostituita automaticamente da TrapDoor con il nome
  126. completo del file di log.
  127.  
  128.  
  129. >>>>    Note particolari riguardanti TrapDoor?
  130.  
  131.     Questa  versione  di  TrapTrxID e` stata sviluppata utilizzando la
  132. versione  1.83  di TrapDoor.  Versioni piu` datate di TrapDoor possono
  133. egualmente  funzionare,  purche`  permettano la ricezione dei messaggi
  134. TrxId,  Name o AKA (fai riferimento alla documentazione della versione
  135. di TrapDoor di cui sei in possesso).
  136.  
  137.     Menzione particolare merita il file di configurazione di TrapDoor.
  138. Affinche`  TrapTrxID possa funzionare correttamente, e` necessario che
  139. in tale file compaia la stringa LOGLEVEL 8:n, con n maggiore di 2.
  140.  
  141.  
  142. >>>>    Come funziona?
  143.  
  144.     TrapTrxID funziona semplicemente cercando nel file di log le linee
  145. di tipo
  146.  
  147. : 26-Dec-92 12:11:01   Name: Nome BBS (2:334/155.0)
  148. : 26-Dec-92 12:11:01    AKA: 2:23331/1.0 3:1/1.0
  149.  
  150. e  verificando che l'indirizzo specificato come parametro coincida con
  151. uno  di  quelli  presenti  in  queste  due  linee.  Se cio` avviene la
  152. prossima linea di tipo
  153.  
  154. : 26-Dec-92 12:11:01  TrxID: 2b3c4bd0/2b3c4ad7
  155.  
  156. servira` per calcolare la differenza temporale tra il proprio orologio
  157. di  sistema  e  quello  del  nodo  col  il  quale abbiamo eseguito una
  158. sessione  EMSI, esattamente calcolando la differenza dei due parametri
  159. esadecimali,  presenti  dopo  la  parola  chiave  TrxID:, ricavando la
  160. differenza  in  secondi  dell'ora  del nodo locale con quella del nodo
  161. remoto.   Naturalmente questa operazione viene fatta considerando solo
  162. l'ultima   sessione.   Una  volta  che  l'orologio  viene  aggiornato,
  163. TrapTrxID aggiunge una linea di tipo
  164.  
  165. " 26-Dec-92 12:34:24  TrapTrxID v1.4 Adjusted by -4:09 (3:1/1.0)
  166.  
  167. in  modo  da  prevenire che TrapTrxID riaggiorni l'orologio fino a una
  168. nuova sessione EMSI.
  169.  
  170.  
  171. >>>>    Bug e problemi?
  172.  
  173.     Fino  ad  oggi  non  ho  riscontrato  nessun tipo di bug in questo
  174. programma.   Esiste  tuttavia un unico problema:  il programma risulta
  175. lento  quando  il file di log e` molto lungo.  Questo inconveniente e`
  176. provocato  dal  fatto  che TrapTrxID esegue una scansione completa del
  177. file  (a  differenza  di altri programmi):  la lentezza e` il pegno da
  178. pagare  per  avere una corretta analisi del file di log.  Consiglierei
  179. vivamente  di usare l'opzione BUFFER, se avete un calcolatore veloce o
  180. se  il  file  di log si trova su una periferica lenta:  questa opzione
  181. aumenta  il  buffer  interno  per  la  gestione dei file riducendo gli
  182. accessi al disco.
  183.  
  184.  
  185. >>>>    Come contattare l'autore in caso di problemi?
  186.  
  187.     Per  ogni  eventuale  problema  o  bug  da me non rilevato, potete
  188. contattarmi al seguente indirizzo e-mail:
  189.  
  190.                Giuseppe Vicari 2:331/105.4@Fidonet.Org
  191.  
  192.  
  193. >>>>    La storia di TrapTrxID?
  194.  
  195.     . v1.4 7 Apr 93:
  196.  
  197.         E'  stato  rifatto  il  codice utilizzando le funzioni tipiche
  198.     dell'AmigaDOS  ottenendo  un  codice  eseguibile  decisamente piu`
  199.     corto,   e  piu`  efficiente;  il  parser  di  linea  e`  AmigaDOS
  200.     compatibile;  alterata  la  linea che scrive TrapTrxID nel file di
  201.     log  (mantenendo  la  compatibilita`  con  le  vecchie  versioni);
  202.     aggiunta  l'opzione  BUFFER;  aggiunta  del  flag  ASK  e  SET; e`
  203.     disponibile il manuale in inglese.
  204.         Try 'version TrapTrxID' ;-)
  205.  
  206.     . v1.3 31 Jan 93:
  207.  
  208.         E`  stato  sistemato  un  difetto  che  mandava  in  crash  il
  209.     calcolatore, a causa dell'ottimizzatore del compilatore.
  210.  
  211.     . v1.2 30 Jan 93:
  212.  
  213.         Ora  e`  possibile non specificare il nome del nodo con cui ci
  214.     si   vuole   sincronizzare,  in  questo  modo  verra`  considerato
  215.     l'ultimo.   Nel caso venga lanciato da WorkBench il programma apre
  216.     una   finestra  e,  dopo  aver  mostrato  la  sintassi  d'uso  del
  217.     programma,  la  richiude  dopo  5  secondi.   E' stata cambiata la
  218.     funzione main() con la _main(), rendendo il codice piu` corto.
  219.  
  220.     . v1.1 22 Jan 93:
  221.  
  222.         Corretto un piccolo bug insignificante (nel file log, scriveva
  223.     l'ora senza lo zero davanti alla cifra se era minore di 10; es.  9
  224.     invece  di  09),  aggiunto  un messaggio d'errore, e riottimizzate
  225.     alcune parti del programma.
  226.  
  227.     . v1.0 3 Jan 93:
  228.  
  229.         Prima versione.
  230.  
  231.  
  232. >>>>    Quanto costa il programma?
  233.  
  234.     Il  programma  puo`  essere  distribuito  e  usato  liberamente  e
  235. gratuitamente, purche` non alteriate nessuna sua parte:  ne` il codice
  236. ne`  la  documentazione  allegata.   Questo e` un programma FD (Freely
  237. Distributable).   Tuttavia  saro`  molto  lieto di accettare qualunque
  238. offerta  di  denaro $-), anzi desidererei molto ricevere una cartolina
  239. del vostro paese, anzi una bella cartolina.  L'indirizzo per ogni tipo
  240. di offerta e` il seguente:
  241.  
  242.                            Giuseppe Vicari
  243.                              via Torni, 7
  244.                         I-21051 Arcisate (VA)
  245.                                 ITALIA
  246.  
  247.     Ringrazio anticipatamente ogni vostra offerta.
  248.  
  249.  
  250. >>>>    Chi bisogna ringraziare?
  251.  
  252.     Vorrei ringraziare le seguenti persone:
  253.  
  254. Matteo Taveggia
  255.     per la correzione e traduzione in inglese dei manuali.
  256.  
  257. Flavio Stanchina e Maurizio Frizzo
  258.     per i loro suggerimenti.
  259.  
  260. Maximilian Hantsch e Martin J. Laubach
  261.     per il loro stupendo programma TrapDoor.
  262.  
  263.  
  264. >>>>    Come assicurarsi dell'originalita` del programma?
  265.  
  266.     All'interno   dell'archivio   e`   stato  inserito  un  programma,
  267. CheckFiles, per verificare l'integrita` e l'originalita` del programma
  268. e  del  manuale.   In  questo  modo  tutti  potranno controllare se il
  269. programma e` stato manomesso o addirittura infettato da qualche virus.
  270. Dopo  aver  estratto  i  file  dall'archivio  si  lancia  il programma
  271. CheckFiles  (attenzione  a  come  scrivi il comando e` case-sensitive)
  272. all'interno  della  directory  dove  si  trovano  i  file estratti; il
  273. programma vi segnalera` i file che sono stati alterati.
  274.  
  275.  
  276. >>>>    Fine del documento
  277.