[avr-libc-dev] [bug #14068] Document non-reentrancy of some library functions

[Joerg Wunsch]

URL:
  <http://savannah.nongnu.org/bugs/?func=detailitem&item_id=14068>

                 Summary: Document non-reentrancy of some library functions
                 Project: AVR C Runtime Library
            Submitted by: joerg_wunsch
            Submitted on: Tue 08/09/05 at 22:42
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: None
                  Status: None
                 Privacy: Public
        Percent Complete: 0%
             Assigned to: None
        Originator Email: address@hidden
             Open/Closed: Open

    _______________________________________________________

Details:

See recent discussion in the avr-libc mailing list
(subject "eeproms and interrupts"):

It should be documented that the library normally does not
make any precautions to be re-entrant.  So anyone calling
library functions from both, interrupt and non-interrupt
contexts should make sure to add the needed protection.

As an example, unprotected access to EEPROM functions from
both contexts could easily disturb the setup of the EEADR
register.

The library itself is believed to be interrupt-save in general
though.

All this ought to be documented.






    _______________________________________________________

Reply to this item at:

  <http://savannah.nongnu.org/bugs/?func=detailitem&item_id=14068>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.nongnu.org/