[DTrace-devel] [oracle/dtrace-utils] 294b90: examples: include a first set of scripts and a REA...

[euloh]

  Branch: refs/heads/dev-queue
  Home:   https://github.com/oracle/dtrace-utils
  Commit: 294b90a49baadf524a3e150395875be1e445302b
      https://github.com/oracle/dtrace-utils/commit/294b90a49baadf524a3e150395875be1e445302b
  Author: Ruud van der Pas <ruud.vanderpas at oracle.com>
  Date:   2025-09-02 (Tue, 02 Sep 2025)

  Changed paths:
    A examples/README.md
    A examples/fcalls.d
    A examples/io-cast-net.d
    A examples/io-stats.d
    A examples/sched-simple.d
    A examples/sched-stats.d
    A examples/thread-ids.d
    A examples/var-scope.d

  Log Message:
  -----------
  examples: include a first set of scripts and a README file

Add 7 example scripts and a README file.

2025-08-28  Ruud van der Pas  <ruud.vanderpas at oracle.com>

	* examples/fcalls.d: List and count function calls.
	* examples/io-cast-net.d: Show how to use wildcards.
	* examples/io-stats.d: Display I/O characteristics.
	* examples/sched-simple.d: Count on/off the CPU.
	* examples/sched-stats.d: Extensive scheduler statistics.
	* examples/thread-ids.d: Mapping of thread IDs.
	* examples/var-scope.d: Demonstrate scoping rules.
	* examples/README.md: Brief description of all examples.

Signed-off-by: Ruud van der Pas <ruud.vanderpas at oracle.com>
Reviewed-by: Eugene Loh <eugene.loh at oracle.com>


  Commit: 4f4d05ba7c621c30b8daff54dbf0ef1535117efc
      https://github.com/oracle/dtrace-utils/commit/4f4d05ba7c621c30b8daff54dbf0ef1535117efc
  Author: Eugene Loh <eugene.loh at oracle.com>
  Date:   2025-09-02 (Tue, 02 Sep 2025)

  Changed paths:
    M examples/README.md
    A examples/language_features/000intro-hello-world.d
    A examples/language_features/001intro-ERROR-probe.d
    A examples/language_features/002intro-global-variables.d
    A examples/language_features/003intro-C-like.d
    A examples/language_features/004intro-ternary.d
    A examples/language_features/005intro-strings.d
    A examples/language_features/006intro-associative.d
    A examples/language_features/007intro-this-variables.d
    A examples/language_features/008intro-self-variables.d
    A examples/language_features/009intro-pragmas.d
    A examples/language_features/010intro-external-variables.d
    A examples/language_features/011intro-preprocessor.d
    A examples/language_features/012intro-predicates.d
    A examples/language_features/100list_probes.sh
    A examples/language_features/101count_probes_by_provider.sh
    A examples/language_features/102list_probe_arguments.sh
    A examples/language_features/110provider_profile.d
    A examples/language_features/120provider_proc.d
    A examples/language_features/130provider_sched_on_off_cpu.d
    A examples/language_features/131provider_sched_enqueue_dequeue.d
    A examples/language_features/140provider_syscall.d
    A examples/language_features/150provider_fbt.d
    A examples/language_features/160provider_sdt_rawtp.sh
    A examples/language_features/170provider_lockstat.sh
    A examples/language_features/171provider_io.d
    A examples/language_features/172provider_ip.d
    A examples/language_features/180provider_cpc.d
    A examples/language_features/200built-in-variables-probe.d
    A examples/language_features/201built-in-variables-timestamps.d
    A examples/language_features/202built-in-variables-args.d
    A examples/language_features/203built-in-variables-process-info.d
    A examples/language_features/204built-in-variables-uregs.d
    A examples/language_features/300actions-exit.sh
    A examples/language_features/301actions-print.d
    A examples/language_features/302actions-strings.d
    A examples/language_features/303actions-strings-paths.d
    A examples/language_features/304actions-system.d
    A examples/language_features/305actions-progenyof.d
    A examples/language_features/306actions-speculations.d
    A examples/language_features/307actions-callstack.d
    A examples/language_features/310actions-alloca-copy.d
    A examples/language_features/311actions-rand.d
    A examples/language_features/500aggregations-intro.d
    A examples/language_features/501aggregations-names-keys.d
    A examples/language_features/502aggregations-basic-funcs.d
    A examples/language_features/503aggregations-stack.d
    A examples/language_features/504aggregations-printa.d
    A examples/language_features/505aggregations-quantize.d
    A examples/language_features/506aggregations-clear-trunc.d
    A examples/language_features/507aggregations-trunc5.d
    A examples/language_features/508aggregations-normalize.d

  Log Message:
  -----------
  examples: Add "language features" demo scripts

The idea is to have lots of short scripts, each illustrating a
D language feature.

The numbering scheme serves two purposes:

*)  the scripts are more or less in ascending order
    of difficulty, although that's admittedly a tricky
    concept in such a multi-dimensional space

*)  there is some grouping of themes -- e.g.,
    "introduction", "providers", "built-in variables", etc.

The combination of comments and code is intended to help either
a human user or an AI bot to learn how to use the D language.

Other examples have been based on functional objectives (doing
simple but useful tasks).  These new examples are based on language
features.  A future set of examples could be based on errors!  That
is, the scripts generate errors of different sorts that we would
illustrate (and explain how to fix).

Signed-off-by: Eugene Loh <eugene.loh at oracle.com>
Reviewed-by: Ruud van der Pas <ruud.vanderpas at oracle.com>


Compare: https://github.com/oracle/dtrace-utils/compare/a48a76472546...4f4d05ba7c62

To unsubscribe from these emails, change your notification settings at https://github.com/oracle/dtrace-utils/settings/notifications