• A
    std: Extract librustrt out of libstd · 5ec36c35
    Alex Crichton 提交于
    As part of the libstd facade efforts, this commit extracts the runtime interface
    out of the standard library into a standalone crate, librustrt. This crate will
    provide the following services:
    
    * Definition of the rtio interface
    * Definition of the Runtime interface
    * Implementation of the Task structure
    * Implementation of task-local-data
    * Implementation of task failure via unwinding via libunwind
    * Implementation of runtime initialization and shutdown
    * Implementation of thread-local-storage for the local rust Task
    
    Notably, this crate avoids the following services:
    
    * Thread creation and destruction. The crate does not require the knowledge of
      an OS threading system, and as a result it seemed best to leave out the
      `rt::thread` module from librustrt. The librustrt module does depend on
      mutexes, however.
    * Implementation of backtraces. There is no inherent requirement for the runtime
      to be able to generate backtraces. As will be discussed later, this
      functionality continues to live in libstd rather than librustrt.
    
    As usual, a number of architectural changes were required to make this crate
    possible. Users of "stable" functionality will not be impacted by this change,
    but users of the `std::rt` module will likely note the changes. A list of
    architectural changes made is:
    
    * The stdout/stderr handles no longer live directly inside of the `Task`
      structure. This is a consequence of librustrt not knowing about `std::io`.
      These two handles are now stored inside of task-local-data.
    
      The handles were originally stored inside of the `Task` for perf reasons, and
      TLD is not currently as fast as it could be. For comparison, 100k prints goes
      from 59ms to 68ms (a 15% slowdown). This appeared to me to be an acceptable
      perf loss for the successful extraction of a librustrt crate.
    
    * The `rtio` module was forced to duplicate more functionality of `std::io`. As
      the module no longer depends on `std::io`, `rtio` now defines structures such
      as socket addresses, addrinfo fiddly bits, etc. The primary change made was
      that `rtio` now defines its own `IoError` type. This type is distinct from
      `std::io::IoError` in that it does not have an enum for what error occurred,
      but rather a platform-specific error code.
    
      The native and green libraries will be updated in later commits for this
      change, and the bulk of this effort was put behind updating the two libraries
      for this change (with `rtio`).
    
    * Printing a message on task failure (along with the backtrace) continues to
      live in libstd, not in librustrt. This is a consequence of the above decision
      to move the stdout/stderr handles to TLD rather than inside the `Task` itself.
      The unwinding API now supports registration of global callback functions which
      will be invoked when a task fails, allowing for libstd to register a function
      to print a message and a backtrace.
    
      The API for registering a callback is experimental and unsafe, as the
      ramifications of running code on unwinding is pretty hairy.
    
    * The `std::unstable::mutex` module has moved to `std::rt::mutex`.
    
    * The `std::unstable::sync` module has been moved to `std::rt::exclusive` and
      the type has been rewritten to not internally have an Arc and to have an RAII
      guard structure when locking. Old code should stop using `Exclusive` in favor
      of the primitives in `libsync`, but if necessary, old code should port to
      `Arc<Exclusive<T>>`.
    
    * The local heap has been stripped down to have fewer debugging options. None of
      these were tested, and none of these have been used in a very long time.
    
    [breaking-change]
    5ec36c35
task.rs 16.2 KB