Skip to content

agl-ic-eg/librefop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

dd219ea · Dec 18, 2022

History

22 Commits
Dec 18, 2022
Aug 4, 2022
Aug 4, 2022
Aug 4, 2022
Aug 4, 2022
Aug 4, 2022
Jul 26, 2022
Jul 26, 2022
Jul 26, 2022
Aug 4, 2022
Aug 4, 2022
Jul 26, 2022
Aug 4, 2022
Aug 4, 2022
Jul 28, 2022
Aug 1, 2022
Aug 1, 2022

Repository files navigation

Redundancy file operation library (librefop)

Redundancy file operation library is a another implementation for the backup 
manager of AGL base system.  It aim to tiny implementation.


Configure option :
  --enable-address-sanitizer
    Enable address sanitizer in build time (for debug, default is no)

  --enable-gcov
    Enable gcov in build time (for debug, default is no)

  --enable-test
    Enable unit test build (requir to gtest and gmock, default is no)


File operation algorithm :

New data write - case 1..

1-0. Initial state.

 --------   
| latest |  
|  file  |  
 --------   

1-1. Create new file.

 --------   
|  New   |  
|  file  |  
 --------   

 --------   
| latest |  
|  file  |  
 --------   

1-2. Rename from latest file to backup file.

 --------   
|  New   |  
|  file  |  
 --------   

                   --------   
             -->  | backup |  
           rename |  file  |  
                   --------   

1-3. Create new data file.

    | rename from new to latest
 --------          --------   
| latest |        | backup |  
|  file  |        |  file  |  
 --------          --------   

1-4. Done.


New data write - case 2.

2-0. Initial state.

 --------          --------   
| latest |        | backup |  
|  file  |        |  file  |  
 --------          --------   

2-1. Create new file.

 --------   
|  New   |  
|  file  |  
 --------   

 --------          --------   
| latest |        | backup |  
|  file  |        |  file  |  
 --------          --------   

2-2. Remove backup file.

 --------   
|  New   |  
|  file  |  
 --------   

 --------                     
| latest |        remove      
|  file  |        backup file 
 --------                     

2-3. Rename from latest file to backup file.

 --------   
|  New   |  
|  file  |  
 --------   

                   --------   
             -->  | backup |  
           rename |  file  |  
                   --------   

2-4. Create new data file.

    | rename from new to latest
 --------          --------   
| latest |        | backup |  
|  file  |        |  file  |  
 --------          --------   

2-5. Done.


Recovery from abnormal conditions.

Note. 'p1,p2' is a file selection priority.  [High pri.] p1 > p2 [Low pri.]

ac1. Nodata

Return a no data.


ac2. Latest file only.

 --------   
| latest |  
|  file  |  
 --------   
    p1

Return data from a latest file.


ac3. Backup file only.

                   --------   
                  | backup |  
                  |  file  |  
                   --------   
                      p1

Return data from a backup file.


ac4. Have a two file (normal condition).

 --------          --------   
| latest |        | backup |  
|  file  |        |  file  |  
 --------          --------   
    p1                p2

Return data from a latest file.


ac5. Latest file and new file.

 --------   
|  New   |  
|  file  |  
 --------   

 --------                      
| latest |                     
|  file  |                     
 --------                      
    p1                         

Return data from a latest file.  Typically new file may not completed write operation.


ac6. Backup file and new file.

 --------   
|  New   |  
|  file  |  
 --------   

                   --------    
                  | backup |   
                  |  file  |   
                   --------    
                      p1       

Return data from a backup file.  Typically new file may not completed write operation.


ac7. Latest file and backup file and new file.

 --------   
|  New   |  
|  file  |  
 --------   

 --------          --------    
| latest |        | backup |   
|  file  |        |  file  |   
 --------          --------    
    p1                p2       

Return data from a latest file.  Typically new file may not completed write operation.

When the data block of high priority file was broken, this library select next priority file.