pub/scm/libs/libcap/libcap.git  about / heads / tags
capability library: includes libcap2 file caps, setcap, getcap and capsh
$ git log --pretty=format:'%h %s (%cs)%d'
13b9ee5 Tidy up some of the automated formatting. (2024-04-05)
	(HEAD -> master, review)
56ee609 doc: document the use of `*` to refer to all users (2024-04-05)
caab620 doc: document pam_cap and its conf (2024-04-03)
e79c7f0 Reformat doc text for web.go (2024-02-18)
17c5e89 getpcaps: fix program name in help message (2024-01-29)
011eb76 Fix reference formatting in the captree man page. (2024-01-12)
ee20d38 Stop using _pam_overwrite() in pam_cap.c. (2023-12-22)
6585135 Restore c89 compaitbility for C source files. (2023-08-13)
4ffb540 Add a check for a capabability of all spaces. (2023-06-24)
ac8d461 Make it harder to set invalid capabilities on files. (2023-06-24)
...

$ git cat-file blob HEAD:README
This is a library for getting and setting POSIX.1e (formerly POSIX 6)
draft 15 capabilities.

Natively supported languages are C/C++ and Go.

This library would not have been possible without the help of 

    Aleph1, Roland Buresund and Andrew Main, Alexander Kjeldaas.

More information on capabilities in the Linux kernel, links to the
official git repository for libcap, release notes and how to report
bugs can be found at:

    http://sites.google.com/site/fullycapable/

The primary upstream git repository is this one:

    https://git.kernel.org/pub/scm/libs/libcap/libcap.git/

# BUILDING AND INSTALLATION

    $ make

       builds the library and the programs that are expected to work
       on your system. For example, if you have Linux-PAM installed,
       pam_cap is built. A golang installation is required to build
       the Go packages.

    $ make test

       runs all of the tests not requiring privilege

    $ make sudotest

       runs all of the tests including those that require privilege.

    $ sudo make install

       default installs the library libcap.XX.Y in /lib[64]/
       the binaries in /sbin/
       the header files in /usr/include
       the {libcap,libpsx}.pc files in /usr/lib[64]/pkgconfig
       the Go packages (if built) under /usr/share/gocode/src

For some example C programs look in the progs/ directory.
Specifically, capsh, getpcaps, setcap and getcap. There are some C
tests in the tests/ directory.

Go example programs are to be found in the goapps/ directory. There
are also some more complicated integration tests in the go/ directory.

There are also some oddball experimental things in the contrib/
directory, but they are mostly curiosities.

Cheers

Andrew G. Morgan <morgan@kernel.org>

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       Tidy up some of the automated formatting. (2024-04-05)
  review       Tidy up some of the automated formatting. (2024-04-05)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
cap/v1.2.69  This is the (stable) version tag for the 'cap' Go package associated with libcap-2.69. (2023-05-14) tar.gz
libcap-korg-2.69 This is libcap-2.69 (2023-05-14) tar.gz
psx/v1.2.69  This is the (stable) version tag for the 'psx' Go package associated with libcap-2.69. (2023-05-14) tar.gz
v1.2.69      This is the version tag for the 'libcap' Go base directory associated with libcap-2.69. (2023-05-14) tar.gz
libcap-2.69  This is libcap-2.69 (2023-05-14) tar.gz
cap/v1.2.68  This is the (stable) version tag for the 'cap' Go package associated with libcap-2.68. (2023-03-25) tar.gz
libcap-korg-2.68 This is libcap-2.68 (2023-03-25) tar.gz
psx/v1.2.68  This is the (stable) version tag for the 'psx' Go package associated with libcap-2.68. (2023-03-25) tar.gz
v1.2.68      This is the version tag for the 'libcap' Go base directory associated with libcap-2.68. (2023-03-25) tar.gz
libcap-2.68  This is libcap-2.68 (2023-03-25) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
         54 linux-security-module
         36 lkml
          7 stable
          6 qemu-devel
          6 linux-api
          5 linux-scsi
          5 linux-arm-kernel
          5 intel-gfx
          5 containers
          4 linux-devicetree
          4 netdev
          3 linuxppc-dev
          3 kvm
          3 git
          3 amd-gfx
          3 u-boot
          3 buildroot
          2 linux-mtd
          2 linux-nvme
          2 linux-xfs
          2 linux-nfs
          2 linux-mediatek
          2 linux-acpi
          2 linux-amlogic
          2 linux-erofs
          2 linux-mm
          2 xen-devel
          2 linux-mips
          2 linux-pm
          2 kvmarm
          2 linux-usb
          2 selinux
          2 linux-rdma
          2 dpdk-dev
          2 linux-pci
          2 linux-bluetooth
          2 linux-ide
          2 linux-serial
          2 dri-devel
          2 linux-omap
          2 linux-remoteproc
          2 linux-arch
          2 openbmc
          2 linux-perf-users
          2 ath11k
          2 linux-s390
          2 ofono
          2 ltp
          2 linux-patches
          2 batman
          2 linux-um
          2 kvm-ppc
          1 linux-samsung-soc
          1 linux-fscrypt
          1 linux-wireless
          1 cocci
          1 linux-block
          1 linux-riscv
          1 live-patching
          1 bpf
          1 linux-crypto
          1 linux-efi
          1 netfilter-devel
          1 linux-integrity
          1 linux-fsdevel
          1 linux-edac
          1 linux-cifs
          1 linux-arm-msm
          1 linux-nvdimm
          1 linux-iommu
          1 linux-media
          1 linux-snps-arc
          1 fstests
          1 linux-hwmon
          1 linux-rtc
          1 linux-input
          1 alsa-devel
          1 linux-btrfs
          1 driverdev-devel
          1 linux-renesas-soc
          1 linux-kselftest
          1 kernel-hardening
          1 linux-clk
          1 linux-iio
          1 linux-gpio
          1 dmaengine
          1 linux-next
          1 linux-parisc
          1 linux-ext4
          1 linux-leds
          1 linux-f2fs-devel
          1 linux-modules
          1 kernelnewbies
          1 linux-rt-users
          1 linux-sgx
          1 linux-watchdog
          1 linux-trace-devel
          1 linux-hyperv
          1 workflows
          1 rcu
          1 linux-m68k
          1 linux-i3c
          1 util-linux
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 wireguard
          1 backports
          1 io-uring
          1 linux-kernel-mentees
          1 linux-doc
          1 linux-csky
          1 linux-man
          1 linux-mmc
          1 tpmdd-devel
          1 linux-unionfs
          1 linux-firmware
          1 cip-dev
          1 linux-audit
          1 linux-spi
          1 linux-i2c
          1 linux-dash
          1 linux-bcache
          1 linux-sparse
          1 mm-commits
          1 linux-pwm
          1 linux-tegra
          1 lttng-dev
          1 virtualization
          1 linux-kbuild
          1 linux-fpga
          1 ceph-devel
          1 linux-can
          1 linux-rockchip
          1 linux-raid
          1 xdp-newbies
          1 platform-driver-x86
          1 phone-devel
          1 linux-hardening
          1 dash
          1 dm-devel
          1 keyrings
          1 linux-fbdev
          1 linux-sctp
          1 linux-cxl
          1 target-devel
          1 lustre-devel
          1 linux-sh
          1 soc
          1 ocfs2-devel
          1 rust-for-linux
          1 ath10k
          1 nouveau
          1 linux-phy
          1 kernel-janitors
          1 sparclinux
          1 linux-staging
          1 linux-sunxi
          1 mptcp
          1 linux-coco
          1 regressions
          1 ksummit
          1 b43-dev
          1 nvdimm
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 llvm
          1 fio
          1 iwd
          1 ell
          1 yocto
          1 yocto-meta-freescale
          1 openembedded-core
          1 yocto-toaster
          1 yocto-meta-arm
          1 yocto-docs
          1 openembedded-devel
          1 bitbake-devel
          1 yocto-meta-virtualization
          1 chrome-platform
          1 ntb
          1 yocto-meta-ti
          1 yocto-meta-arago
          1 outreachy
          1 xenomai
          1 damon
          1 asahi
          1 openrisc
          1 intel-wired-lan
          1 kexec
          1 loongarch
          1 imx
          1 ath12k
          1 b4-sent
          1 linux-trace-kernel
          1 oe-linux-nfc
          1 oe-kbuild-all
          1 oe-chipsec
          1 intel-xe
          1 virtio-dev
          1 virtio-comment
          1 v9fs
          1 ecryptfs
          1 poky
          1 qemu-riscv
          1 linux-ia64
          1 cluster-devel
          1 grub-devel
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 cgroups
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-alpha
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-hexagon
          1 linux-hotplug
          1 linux-laptop
          1 linux-sound
          1 trinity
          1 reiserfs-devel
          1 linux-metag
          1 linux-x25
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 u-boot-amlogic
          1 lm-sensors
          1 lvm-devel
          1 acpica-devel
          1 perfbook
          1 virtio-fs
          1 smatch
          1 ../../../../../fuego
          1 ../../../../../wireless-regdb
          1 ../../../../../igt-dev
          1 ../../../../../powertop

git clone https://yhbt.net/lore/pub/scm/libs/libcap/libcap.git