cargo-bins / jobslot

An implementation of the GNU make jobserver for Rust; fork for Binstall

jobslot

An implementation of the GNU make jobserver for Rust

Documentation

Advantages over jobserver?

• jobslot contains bug fix for Client::configure is unsafe
• jobslot removed use of signal handling in the helper thread on unix
• jobslot uses windows-sys on windows instead of manually declaring bindings (some of the bindings seem to be wrong)
• jobslot uses getrandom on windows instead of making homebrew one using raw windows api
• jobslot::Client::from_env can be called any number of times on Windows and Unix.

Usage

First, add this to your Cargo.toml:

[dependencies]
jobslot = "0.2"

Use of this crate in rustc

This crate uses getrandom v0.2.7 on windows. If you want to use this crate in rustc, make sure to bump getrandom to v0.2 to avoid pulling in different major versions of the same crate.

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in jobslot by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

jobslot's Issues

Publish this crate in a new name

I'd plan to publish this crate in a new name and submit a PR to cc and other dependents to use this crate, which contains various fix and performance optimization (it can use posix_spawn on unix, which could use vfork instead of fork).

What name should we use?
And is there anything we need to be careful?

Bug: Compatibility with `make`

Ref: rust-lang/cc-rs#962

Use `env::var_os` in `Client::from_env` to accept non-utf8 characters

Reenter syscall on EINTR

On Unix, syscall could return EINTR due to signal delivery.

Add new API for creating jobserver and run cmds with the named fifo on unix

• Add new function call Client::new_with_named_pipe to creates named pipe instead of annoymous pipe on unix
• Add new function call Client::configure_and_run_with_named_pipe to use named pipe on unix
  which gives better performance on unix since it can use vfork.

Migrate from winapi to official windows crate

https://microsoft.github.io/windows-docs-rs/doc/windows/