Changes between Version 1 and Version 2 of Architecture

Timestamp:

Jun 30, 2006, 1:35:19 PM (18 years ago)

Author:

soujak

Comment:

--

Architecture

@@ -2 +2 @@
 
 == 1. File system organization ==
-Kaya Phase 1 distribution is subdivided in several folders in order to 
-efficiently organize files and logically separate them into different sections.
-Such division is thought for being ready to receive Phase 2 implementation 
-providing a well structured environment.
- * `src/`: sources folder containing Phase 1 primitive functions source code,
-   as described below in paragraph 2;
- * `test/`: testing folder, containing a debugging program (`p1test.c`), related
-   environment generated by the Makefile "`test`" target; this rule compiles,
-   links, creates uMPS executable and virtual devices and finally run it on the
-   uMPS virtual machine (see also README);
+The distribution is subdivided in several folders in order to efficiently
+organize files and logically separate them into different sections.
+Kaya is a layered OS, so each Phase has been confined in a sub-distribution
+own hierarchy, in order to ease interchanges between different implementation
+of the same layer and to underline that opportunity.
+In addition to this, each Phase has the classic structure
+
+ * `phase`''N''`/`
+   * `src/`: sources folder containing Phase ''N'' source code and a test programs;
+   * `obj/`: Phase ''N'' objects files;
+   * `include/`: library headers of Phase ''N'';
+ * `include/`: system common headers: constants and macro definitions
+   (`const.h`), types and data structures definitions (`types.h`);
+ * `dev/`: uMPS virtual devices;
  * `doc/`: documentation root containing various developers informations about 
-   project internals;
- * `include/`: library headers
-   * `*.e`: Phase 1 primitive functions interfaces: `pcb.e` and `st.e` 
-     respectively relative to `pcb.c` and `st.c`;
-   * `*.h`: system constants and macro definitions (`const.h`), types and data 
-     structures definitions (`types.h`);
- * `lib/`: Phase 1 libraries objects files, ready for being linked.
+   project internals and development process.
 
 == 2. Source modules organization ==
-Following the evident logical division between two entities we have to 
+
+=== 2.1. Phase 1 ===
+Following the evident logical division between two entities that we had to 
 instantiate - processes and semaphores -, we opted for a two-modules subdivision:
  * `pcb.c`: collects primitive functions for PCBs initialization/ allocation/
@@ -29 +29 @@
    enqueueing to/dequeueing from semaphores.
 
-{{{
- * `check.c` contains an error check routine which is able to perform a simple type
-   check on the own data structures of Phase 1.
-}}}
+=== 2.2. Phase 2 ===