Skip to content

docs(readme): use node-subtensor bin name and -p flag for cargo run#2608

Open
boskodev790 wants to merge 1 commit intoopentensor:mainfrom
boskodev790:fix/readme-cargo-run-and-binary-name
Open

docs(readme): use node-subtensor bin name and -p flag for cargo run#2608
boskodev790 wants to merge 1 commit intoopentensor:mainfrom
boskodev790:fix/readme-cargo-run-and-binary-name

Conversation

@boskodev790
Copy link
Copy Markdown

@boskodev790 boskodev790 commented Apr 22, 2026

Fixes #1807.

  • The workspace root Cargo.toml has no [[bin]] target and the workspace contains multiple bin crates, so cargo run --release -- --dev fails with error: a bin target must be available for cargo run. Change the example to cargo run --release -p node-subtensor -- --dev and add a one-sentence explainer.
  • The "Other ways to launch the node" section referenced the binary as ./target/release/subtensor (x3); the produced binary is node-subtensor per node/Cargo.toml.
  • One of those lines read ./target/release/subtensor-ldebug --dev where the -ldebug log-filter flag had fused into the binary name. Restore the space.

Description

Related Issue(s)

  • Closes #[issue number]

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Other (please describe):

Breaking Change

If this PR introduces a breaking change, please provide a detailed description of the impact and the migration path for existing applications.

Checklist

  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have run ./scripts/fix_rust.sh to ensure my code is formatted and linted correctly
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules

Screenshots (if applicable)

Please include any relevant screenshots or GIFs that demonstrate the changes made.

Additional Notes

Please provide any additional information or context that may be helpful for reviewers.

Fixes opentensor#1807.

- The workspace root Cargo.toml has no [[bin]] target and the workspace
  contains multiple bin crates, so `cargo run --release -- --dev` fails
  with `error: a bin target must be available for cargo run`. Change the
  example to `cargo run --release -p node-subtensor -- --dev` and add a
  one-sentence explainer.
- The "Other ways to launch the node" section referenced the binary as
  `./target/release/subtensor` (x3); the produced binary is
  `node-subtensor` per node/Cargo.toml.
- One of those lines read `./target/release/subtensor-ldebug --dev`
  where the `-ldebug` log-filter flag had fused into the binary name.
  Restore the space.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

error: a bin target must be available for cargo run

1 participant