Skip to content

bpftrace/user-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

user-tools

This repository contains community contributed tools. This is different from official bpftrace tools in that we do not intend to be as strict about requirements.

Thus, we encourage users to contribute anything they find useful for the community. Motivations could include (but are not limited to):

  • Sharing useful functionality
  • Sharing novel techniques
  • Incubating a new official tool

One intention is that all new official tools begin life in this repository. And over time we'll develop some criteria for promoting a user tool to an official tool that bpftrace maintainers will help support over long periods of time.

If you want to contribute bpftrace tools to this repo, please follow these guidelines.

Packaging

This repository should NOT be packaged and distributed. It is essentially a large collection of unsupported, possibly broken, sample code. This is not a typical software project but rather a programmer's community, similar to a subreddit. The only bpftrace tools that are packaged are those included in the primary bpftrace repository.

Licensing

Depending on which BPF helpers are used by bpftrace when compiling your program, a GPL-compatible license is required for bpftrace programs/tools.

You can set the license as a comment in your source code (at the top of the file). Note: it supports multiple words and quotes are not necessary. If the license is not specified, bpftrace will automatically define the license of the program as GPL v2.

Examples:

  • // SPDX-License-Identifier: GPL-2.0-or-later
  • // SPDX-License-Identifier: GPL-2.0-or-later OR BSD-2-Clause

Currently, only these licenses are supported in this repo:

  • GPL
  • GPL v2
  • Dual BSD/GPL
  • Dual MIT/GPL
  • Dual MPL/GPL

Note: GPL v3 is not supported.

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •