Google Git
Sign in
android / platform / external / rust / crates / untrusted / 29604560d1d6e7b9ad7cce124b9d8c52a2ff4d52
commit29604560d1d6e7b9ad7cce124b9d8c52a2ff4d52[log] [tgz]
authorDavid LeGare <legare@google.com>Mon Mar 07 12:52:00 2022 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Mon Mar 07 12:52:00 2022 +0000
treee9a1632044ee69a254959447f4fc2e9b8151eb3f
parent4bd63c1f77250eaba61cc6e05c68f0d5417c4489 [diff]
parent4e8852f3d2a148183cbad3b8189c8ae42ba5d4ac [diff]
Update TEST_MAPPING am: 4e8852f3d2

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/untrusted/+/2006200

Change-Id: I52653cf42eda3dccd93b6b1de367a568cf8f8cf7
tree: e9a1632044ee69a254959447f4fc2e9b8151eb3f
  1. patches/
  2. src/
  3. tests/
  4. LICENSE ⇨ LICENSE.txt
  5. .cargo_vcs_info.json
  6. .gitattributes
  7. .gitignore
  8. .travis.yml
  9. Android.bp
  10. Cargo.toml
  11. cargo2android.json
  12. LICENSE.txt
  13. METADATA
  14. MODULE_LICENSE_ISC
  15. OWNERS
  16. README.md
  17. rustfmt.toml
  18. TEST_MAPPING
README.md

THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHORS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

untrusted.rs

Safe, fast, zero-panic, zero-crashing, zero-allocation parsing of untrusted inputs in Rust.

untrusted.rs is 100% Rust with no use of unsafe. It never uses the heap. No part of untrusted.rs's API will ever panic or cause a crash. It is #![no_std] and so it works perfectly with both libcore- and libstd- based projects. It does not depend on any crates other than libcore.

untrusted.rs is intended to be used with the latest version of Rust Stable. It should usually work with the latest Rust Beta and Rust Nightly versions too. Using a version of untrusted.rs other than the latest release available on crates.io is not recommended.

Documentation

See the documentation at https://briansmith.org/rustdoc/untrusted/.

To use untrusted.rs in your project, add a dependency to your Cargo.toml like this:

[dependencies]
untrusted = "0.2"

Examples

ring's parser for the subset of ASN.1 DER it needs to understand, ring::der, is built on top of untrusted.rs. ring also uses untrusted.rs to parse ECC public keys, RSA PKCS#1 1.5 padding, and everything else.

All of webpki's parsing of X.509 certificates (also ASN.1 DER) is done using untrusted.rs.

Contributing

Patches welcome!

When contributing changes, state that you agree to license your contribution under the same terms as the existing code by putting this at the bottom of your commit message:


I agree to license my contributions to each file under the terms given
at the top of each file I changed.

Currently, the biggest needs for this library are:

  • Unit tests.
  • Documentation.
  • More examples.
  • Static analysis and fuzzing.

Online Automated Testing

Travis CI is used for Android, Linux, and Mac OS X. The tests are run for the current release of each Rust channel (Stable, Beta, Nightly). Since untrusted.rs only depends on libcore and it only uses 100% cross-platform code without using unsafe, it should work anywhere as long as these platforms are passing.

<img src=https://travis-ci.org/briansmith/untrusted.svg?branch=master>

Bug Reporting

Please report bugs either as pull requests or as issues in the issue tracker. untrusted.rs has a full disclosure vulnerability policy. Please do NOT attempt to report any security vulnerability in this code privately to anybody.

License

See LICENSE.txt, an ISC-style (simplified MIT) license.