1
0
Fork 0
mirror of https://github.com/NixOS/nix synced 2025-06-24 22:11:15 +02:00
No description
Find a file
Sergei Zimmerman 5e74c0e4d6
libexpr: Add SampleStack stack-sampling profiler
This patch adds support for a native stack sampling
profiler to the evaluator, which saves a collapsed stack
profile information to a configurable location.

Introduced options (in `EvalSettings`):

- `eval-profile-file` - path to the collected profile file.
- `eval-profiler-frequency` - sampling frequency.
- `eval-profiler` - enumeration option for enabling the profiler.

  Currently only `flamegraph` is supported, but having this an
  enumeration rather than a boolean switch leaves the door open
  for other profiler variants (e.g. tracy).

Profile includes the following information on best-effort basis (e.g. some lambdas might
have an undefined name). Callstack information contains:

- Call site location (where the function gets called).
- Primop/lambda name of the function being called.
- Functors/partial applications don't have a name attached to them unlike special-cased primops and lambads.

For cases where callsite location isn't available we have to resort to providing
the location where the lambda itself is defined. This removes some of the confusing
`«none»:0` locations in the profile from previous attempts.

Example usage with piping directly into zstd for compression:

```
nix eval --no-eval-cache nixpkgs#nixosTests.gnome \
  --eval-profiler flamegraph \
  --eval-profile-file >(zstd -of nix.profile.zstd)
```

Co-authored-by: Jörg Thalheim <joerg@thalheim.io>
2025-05-21 20:15:19 +00:00
.github fix(docs): update Matrix channel links 2025-05-04 12:17:48 +02:00
contrib function-trace: always show the trace 2019-09-18 23:23:21 +02:00
doc/manual Merge pull request #13224 from NixOS/nix-profile-add 2025-05-20 20:15:31 +02:00
maintainers Merge pull request #13189 from NixOS/rl-next 2025-05-14 19:58:59 -04:00
misc Install init system configs only when relevant 2024-12-03 16:51:01 +01:00
nix-meson-build-support Add -Wundef to make #if FOO an error if not defined 2025-04-05 00:45:19 +02:00
packaging Merge pull request #13142 from xokdvium/gc-root-boost-regex 2025-05-18 21:44:41 +02:00
scripts Merge pull request #12423 from ilya-bobyr/fish-profile-local-state-bin-in-PATH 2025-04-18 07:27:04 +02:00
src libexpr: Add SampleStack stack-sampling profiler 2025-05-21 20:15:19 +00:00
tests Merge pull request #13224 from NixOS/nix-profile-add 2025-05-20 20:15:31 +02:00
.clang-format Factor out lookupExecutable and other PATH improvments 2024-08-07 18:12:58 -04:00
.clang-tidy Add .clang-tidy 2024-02-01 01:01:39 +01:00
.dir-locals.el .dir-locals.el: Set c-block-comment-prefix 2020-07-10 11:21:06 +02:00
.editorconfig No global eval settings in libnixexpr 2024-06-24 12:15:16 -04:00
.gitignore Expand manual on derivation outputs 2025-02-27 02:13:36 -05:00
.mergify.yml .mergify.yml: Add backport 2.29-maintenance entry 2025-05-14 19:59:22 -04:00
.shellcheckrc housekeeping: shellcheck for tests/functional/ca/build-cache.sh 2024-06-12 17:41:16 -04:00
.version Bump version 2025-05-14 19:59:22 -04:00
CITATION.cff chore: PhD thesis as reference in CITATION.cff 2024-05-18 20:05:22 +02:00
CONTRIBUTING.md Rename doc/manual{src -> source} 2024-10-14 11:21:24 -04:00
COPYING * Change this to LGPL to keep the government happy. 2006-04-25 16:41:06 +00:00
default.nix Format .nix files 2025-01-24 17:04:02 +01:00
docker.nix Reduce maxLayers to 70 in docker build 2025-05-08 09:56:14 +02:00
flake.lock flake.lock: Update 2025-05-15 11:31:34 +02:00
flake.nix Explain the use of "2" in the overlay 2025-04-20 17:20:54 -04:00
HACKING.md Rename doc/manual{src -> source} 2024-10-14 11:21:24 -04:00
meson.build Fix meson warning about meson_version 1.1 2025-04-09 15:31:34 +02:00
meson.options Don't build the API docs in the devshell 2024-11-12 20:18:33 +01:00
precompiled-headers.h Build a minimized Nix with MinGW 2024-04-17 12:26:10 -04:00
README.md fix(docs): update Matrix channel links 2025-05-04 12:17:48 +02:00
shell.nix Remove url literals 2022-01-24 13:28:21 +01:00

Nix

Open Collective supporters CI

Nix is a powerful package manager for Linux and other Unix systems that makes package management reliable and reproducible. Please refer to the Nix manual for more details.

Installation and first steps

Visit nix.dev for installation instructions and beginner tutorials.

Full reference documentation can be found in the Nix manual.

Building and developing

Follow instructions in the Nix reference manual to set up a development environment and build Nix from source.

Contributing

Check the contributing guide if you want to get involved with developing Nix.

Additional resources

Nix was created by Eelco Dolstra and developed as the subject of his PhD thesis The Purely Functional Software Deployment Model, published 2006. Today, a world-wide developer community contributes to Nix and the ecosystem that has grown around it.

License

Nix is released under the LGPL v2.1.