ceph-csi/vendor/github.com/prometheus/procfs
dependabot[bot] b2ae48dc2d rebase: bump the github-dependencies group with 5 updates
Bumps the github-dependencies group with 5 updates:

| Package | From | To |
| --- | --- | --- |
| [github.com/aws/aws-sdk-go](https://github.com/aws/aws-sdk-go) | `1.49.0` | `1.49.13` |
| [github.com/aws/aws-sdk-go-v2/service/sts](https://github.com/aws/aws-sdk-go-v2) | `1.26.5` | `1.26.6` |
| [github.com/google/uuid](https://github.com/google/uuid) | `1.4.0` | `1.5.0` |
| [github.com/kubernetes-csi/csi-lib-utils](https://github.com/kubernetes-csi/csi-lib-utils) | `0.14.0` | `0.17.0` |
| [github.com/prometheus/client_golang](https://github.com/prometheus/client_golang) | `1.17.0` | `1.18.0` |


Updates `github.com/aws/aws-sdk-go` from 1.49.0 to 1.49.13
- [Release notes](https://github.com/aws/aws-sdk-go/releases)
- [Commits](https://github.com/aws/aws-sdk-go/compare/v1.49.0...v1.49.13)

Updates `github.com/aws/aws-sdk-go-v2/service/sts` from 1.26.5 to 1.26.6
- [Release notes](https://github.com/aws/aws-sdk-go-v2/releases)
- [Commits](https://github.com/aws/aws-sdk-go-v2/compare/service/s3/v1.26.5...service/s3/v1.26.6)

Updates `github.com/google/uuid` from 1.4.0 to 1.5.0
- [Release notes](https://github.com/google/uuid/releases)
- [Changelog](https://github.com/google/uuid/blob/master/CHANGELOG.md)
- [Commits](https://github.com/google/uuid/compare/v1.4.0...v1.5.0)

Updates `github.com/kubernetes-csi/csi-lib-utils` from 0.14.0 to 0.17.0
- [Release notes](https://github.com/kubernetes-csi/csi-lib-utils/releases)
- [Commits](https://github.com/kubernetes-csi/csi-lib-utils/compare/v0.14.0...v0.17.0)

Updates `github.com/prometheus/client_golang` from 1.17.0 to 1.18.0
- [Release notes](https://github.com/prometheus/client_golang/releases)
- [Changelog](https://github.com/prometheus/client_golang/blob/main/CHANGELOG.md)
- [Commits](https://github.com/prometheus/client_golang/compare/v1.17.0...v1.18.0)

---
updated-dependencies:
- dependency-name: github.com/aws/aws-sdk-go
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: github-dependencies
- dependency-name: github.com/aws/aws-sdk-go-v2/service/sts
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: github-dependencies
- dependency-name: github.com/google/uuid
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: github-dependencies
- dependency-name: github.com/kubernetes-csi/csi-lib-utils
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: github-dependencies
- dependency-name: github.com/prometheus/client_golang
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: github-dependencies
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-01-03 21:23:15 +00:00
..
internal rebase: bump github.com/prometheus/client_golang from 1.15.1 to 1.16.0 2023-06-20 13:06:40 +00:00
.gitignore rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
.golangci.yml rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
arp.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
buddyinfo.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
cmdline.go rebase: bump github.com/prometheus/client_golang from 1.11.0 to 1.12.0 2022-01-20 07:02:06 +00:00
CODE_OF_CONDUCT.md rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
CONTRIBUTING.md rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_armx.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_loong64.go rebase: bump github.com/prometheus/client_golang from 1.14.0 to 1.15.1 2023-05-04 17:22:30 +00:00
cpuinfo_mipsx.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_others.go rebase: bump github.com/prometheus/client_golang from 1.14.0 to 1.15.1 2023-05-04 17:22:30 +00:00
cpuinfo_ppcx.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_riscvx.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_s390x.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo_x86.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
cpuinfo.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
crypto.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
doc.go rebase: bump github.com/prometheus/client_golang from 1.14.0 to 1.15.1 2023-05-04 17:22:30 +00:00
fs_statfs_notype.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
fs_statfs_type.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
fs.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
fscache.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
ipvs.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
kernel_random.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
LICENSE vendor update for E2E framework 2019-06-04 11:39:42 +05:30
loadavg.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
MAINTAINERS.md Migrate from dep to go module 2020-03-17 10:44:07 +00:00
Makefile rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
Makefile.common rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
mdstat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
meminfo.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
mountinfo.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
mountstats.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
net_conntrackstat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_dev.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
net_ip_socket.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_protocols.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_route.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_sockstat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_softnet.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_tcp.go rebase: update packages in go.mod to latest releases 2021-06-04 11:52:22 +00:00
net_udp.go rebase: update packages in go.mod to latest releases 2021-06-04 11:52:22 +00:00
net_unix.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_wireless.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
net_xfrm.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
netstat.go rebase: bump github.com/prometheus/client_golang from 1.15.1 to 1.16.0 2023-06-20 13:06:40 +00:00
NOTICE vendor update for E2E framework 2019-06-04 11:39:42 +05:30
proc_cgroup.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_cgroups.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_environ.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
proc_fdinfo.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
proc_interrupts.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_io.go Update to kube v1.17 2020-01-17 12:06:02 +00:00
proc_limits.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_maps.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
proc_netstat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_ns.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_psi.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_smaps.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_snmp6.go rebase: bump github.com/prometheus/client_golang from 1.14.0 to 1.15.1 2023-05-04 17:22:30 +00:00
proc_snmp.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_stat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc_status.go rebase: bump the github-dependencies group with 5 updates 2024-01-03 21:23:15 +00:00
proc_sys.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
proc.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
README.md rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
schedstat.go rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
SECURITY.md rebase: bump github.com/prometheus/client_golang from 1.12.2 to 1.14.0 2022-11-30 16:32:45 +00:00
slab.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
softirqs.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
stat.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
swaps.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
thread.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
ttar Migrate from dep to go module 2020-03-17 10:44:07 +00:00
vm.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00
zoneinfo.go rebase: bump the github-dependencies group with 2 updates 2023-09-29 12:09:42 +00:00

procfs

This package provides functions to retrieve system, kernel, and process metrics from the pseudo-filesystems /proc and /sys.

WARNING: This package is a work in progress. Its API may still break in backwards-incompatible ways without warnings. Use it at your own risk.

Go Reference CircleCI Go Report Card

Usage

The procfs library is organized by packages based on whether the gathered data is coming from /proc, /sys, or both. Each package contains an FS type which represents the path to either /proc, /sys, or both. For example, cpu statistics are gathered from /proc/stat and are available via the root procfs package. First, the proc filesystem mount point is initialized, and then the stat information is read.

fs, err := procfs.NewFS("/proc")
stats, err := fs.Stat()

Some sub-packages such as blockdevice, require access to both the proc and sys filesystems.

    fs, err := blockdevice.NewFS("/proc", "/sys")
    stats, err := fs.ProcDiskstats()

Package Organization

The packages in this project are organized according to (1) whether the data comes from the /proc or /sys filesystem and (2) the type of information being retrieved. For example, most process information can be gathered from the functions in the root procfs package. Information about block devices such as disk drives is available in the blockdevices sub-package.

Building and Testing

The procfs library is intended to be built as part of another application, so there are no distributable binaries.
However, most of the API includes unit tests which can be run with make test.

Updating Test Fixtures

The procfs library includes a set of test fixtures which include many example files from the /proc and /sys filesystems. These fixtures are included as a ttar file which is extracted automatically during testing. To add/update the test fixtures, first ensure the fixtures directory is up to date by removing the existing directory and then extracting the ttar file using make fixtures/.unpacked or just make test.

rm -rf testdata/fixtures
make test

Next, make the required changes to the extracted files in the fixtures directory. When the changes are complete, run make update_fixtures to create a new fixtures.ttar file based on the updated fixtures directory. And finally, verify the changes using git diff testdata/fixtures.ttar.