Ignore:
Timestamp:
Jun 3, 2017, 4:46:59 PM (7 years ago)
Author:
max@…
Message:

cosmetic, and a few typos

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/kernel/kern/dqdt.h

    r14 r19  
    11/*
    22 * kern/dqdt.h - Distributed Quad Decision Tree
    3  * 
     3 *
    44 * Author : Alain Greiner (2016)
    55 *
     
    3535 * - If X_SIZE or Y_SIZE are equal to 1, it makes the assumption that the cluster
    3636 *   topology is a one dimensionnal vector, an build the smallest one-dimensionnal
    37  *   quad-tree covering this one-dimensionnal vector. If the number of clusters 
     37 *   quad-tree covering this one-dimensionnal vector. If the number of clusters
    3838 *   is not a power of 4, the tree is truncated as required.
    3939 *   TODO : the mapping for the one dimensionnal topology is not implemented yet [AG].
    40  * 
    41  * - If both Y_SIZE and Y_SIZE are larger than 1, it makes the assumption that 
    42  *   the cluster topology is a 2D mesh. The [X,Y] coordinates of a cluster are 
    43  *   obtained from the CXY identifier using the following rules : 
     40 *
     41 * - If both Y_SIZE and Y_SIZE are larger than 1, it makes the assumption that
     42 *   the cluster topology is a 2D mesh. The [X,Y] coordinates of a cluster are
     43 *   obtained from the CXY identifier using the following rules :
    4444 *      X = CXY >> Y_WIDTH   /  Y = CXY & ((1<<Y_WIDTH)-1)
    45  *   If the mesh X_SIZE and Y_SIZE dimensions are not equal, or are not power of 2, 
     45 *   If the mesh X_SIZE and Y_SIZE dimensions are not equal, or are not power of 2,
    4646 *   we build the smallest two dimensionnal quad-tree covering all clusters,
    4747 *   and this tree is truncated as required.
    4848 *   The root node is always implemented in cluster [0,0]
    4949 *   The mesh size is supposed to contain at most 32 * 32 clusters.
    50  *   There are at most 6 DQDT nodes in a cluster 
     50 *   There are at most 6 DQDT nodes in a cluster
    5151 *   . Level 0 nodes exist on all clusters and have no children.
    52  *   . Level 1 nodes exist when both X and Y coordinates are multiple of 2 
     52 *   . Level 1 nodes exist when both X and Y coordinates are multiple of 2
    5353 *   . Level 2 nodes exist when both X and Y coordinates are multiple of 4
    5454 *   . Level 3 nodes exist when both X and Y coordinates are multiple of 8
     
    7676
    7777/****************************************************************************************
    78  * This local function initializes the local DQDT structures. 
     78 * This local function initializes the local DQDT structures.
    7979 * The information describing the hardware platform topology and the cluster
    8080 * indexing policy is defined by the three arguments below.
    81  * This initialisation is done in parallel, locally in each cluster, because the DQDT 
     81 * This initialisation is done in parallel, locally in each cluster, because the DQDT
    8282 * is allocated as a global variable in the cluster_manager, and the local addresses
    8383 * are identical in all clusters.
     
    118118 * This local function updates both the total number of threads,
    119119 * in the level 0 DQDT node, and the variation of the number of threads
    120  * for future propagation to the DQDT upper levels. 
     120 * for future propagation to the DQDT upper levels.
    121121 * It should be called on each thread creation or destruction.
    122122 ****************************************************************************************
     
    128128 * This local function updates both the total number of allocated pages,
    129129 * in the level 0 DQDT node, and the variation of the number of pages
    130  * for future propagation to the DQDT upper levels. 
     130 * for future propagation to the DQDT upper levels.
    131131 * It should be called on each memory allocation or release.
    132132 ****************************************************************************************
     
    146146/****************************************************************************************
    147147 * This function can be called in any cluster. It traverses the DQDT tree
    148  * from the root to the bottom, to analyse the memory load and select the cluster 
     148 * from the root to the bottom, to analyse the memory load and select the cluster
    149149 * with the lowest memory load for dynamic memory allocation with no locality constraint.
    150150 ****************************************************************************************
Note: See TracChangeset for help on using the changeset viewer.