Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

document the buildtime environment variables #374

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

ksimpson-work
Copy link
Contributor

close #106

WIP see question added to issue #106

Copy link

copy-pr-bot bot commented Jan 10, 2025

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@ksimpson-work ksimpson-work requested review from vzhurba01 and leofang and removed request for vzhurba01 January 10, 2025 17:48
@@ -308,9 +315,9 @@ def build_extension(self, ext):
# Allow extensions to discover libraries at runtime
# relative their wheels installation.
if ext.name == "cuda.bindings._bindings.cynvrtc":
ldflag = f"-Wl,--disable-new-dtags,-rpath,$ORIGIN/../../../nvidia/cuda_nvrtc/lib"
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it would appear this file escaped ruff linting in a previous commit

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we need to get #255 done soon (cc @shwina)

DeprecationWarning,
stacklevel=1,
)
nthreads = int(os.environ.get("CUDA_PYTHON_PARALLEL_LEVEL", "0") or "0")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This treatment ignored PARALLEL_LEVEL, so it means PARALLEL_LEVEL is not deprecated but removed.

@@ -46,6 +46,12 @@ During the build process, environment variable `CUDA_HOME` or `CUDA_PATH` are us
export CUDA_HOME=/usr/local/cuda
```

Some other build time environment variables are as follows:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you create a new page "environment variables", move the text there & also add run-time env vars, and link it to index.rst & cross-ref it here? This way we have env vars easily findable on table of contents. Right now you have to know what you're looking for.

@leofang leofang added this to the cuda-python 12-next, 11-next milestone Jan 12, 2025
@leofang leofang added documentation Improvements or additions to documentation P0 High priority - Must do! cuda.bindings Everything related to the cuda.bindings module P1 Medium priority - Should do and removed P0 High priority - Must do! labels Jan 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cuda.bindings Everything related to the cuda.bindings module documentation Improvements or additions to documentation P1 Medium priority - Should do
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document all available build-time and run-time environment variables
2 participants