3.3 Quit

It's time to say goodbye to kernel. But before this, you need to save the list you previously initialized and managed back into ~/.recently-used.xbel(In the mean time, don't forget to save the page number if you want). This is very easy to you, just call this function:

    void rur_close(RurItem *list);

This function will do the following things for you:

• open ~/.recently-used.xbel file for read and write
  At the end of 3.1 step, rur will close the ~/.recently-used.xbel file, so, we must open this file again at the 3.3 step.
• lock ~/.recently-used.xbel file
• re-load ~/.recently-used.xbel file
  During your program's lifetime, another program may write back into the ~/.recently-used.xbel file. Your program can't overwrite the changes that made by other programs. So, rur need read the ~/.recently-used.xbel content again before she write you RurItem list back into this file.
• write list back into file
  rur judge the item's status member one-by-one, if it is not OLD, we'll write the item's information back into the file except the status is DELETE. rur will delete the DELETE status entry in the ~/.recently-used.xbel file, this is the actually delete action.

  Like in section 3.1, rur treat the following situation respective:

  • file ~/.recently-used.xbel exist but not legal
  • file ~/.recently-used.xbel does not exist and can't be created.

      rur will not write the list back into disk.

  • file ~/.recently-used.xbel does not exist and could be created
  • file ~/.recently-used.xbel exist and have the DBSS compliant content.

      rur will write list back into disk successfully.

• unlock file
• free memory of rur