@fredlackey/devutils 0.0.18 → 0.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (331) hide show
  1. package/README.md +32 -150
  2. package/package.json +5 -82
  3. package/bin/dev.js +0 -16
  4. package/files/README.md +0 -0
  5. package/files/claude/.claude/commands/setup-context.md +0 -3
  6. package/files/monorepos/_archive/README.md +0 -36
  7. package/files/monorepos/_legacy/README.md +0 -36
  8. package/files/monorepos/ai-docs/README.md +0 -33
  9. package/files/monorepos/apps/README.md +0 -24
  10. package/files/monorepos/docs/README.md +0 -40
  11. package/files/monorepos/packages/README.md +0 -25
  12. package/files/monorepos/research/README.md +0 -29
  13. package/files/monorepos/scripts/README.md +0 -24
  14. package/src/cli.js +0 -72
  15. package/src/commands/README.md +0 -41
  16. package/src/commands/configure.js +0 -199
  17. package/src/commands/identity.js +0 -1630
  18. package/src/commands/ignore.js +0 -247
  19. package/src/commands/install.js +0 -526
  20. package/src/commands/setup.js +0 -246
  21. package/src/commands/status.js +0 -223
  22. package/src/commands/update.js +0 -142
  23. package/src/commands/version.js +0 -100
  24. package/src/completion.js +0 -284
  25. package/src/constants.js +0 -45
  26. package/src/ignore/claude-code.txt +0 -10
  27. package/src/ignore/docker.txt +0 -18
  28. package/src/ignore/linux.txt +0 -23
  29. package/src/ignore/macos.txt +0 -36
  30. package/src/ignore/node.txt +0 -55
  31. package/src/ignore/terraform.txt +0 -37
  32. package/src/ignore/vscode.txt +0 -18
  33. package/src/ignore/windows.txt +0 -35
  34. package/src/index.js +0 -0
  35. package/src/installs/README.md +0 -399
  36. package/src/installs/adobe-creative-cloud.js +0 -546
  37. package/src/installs/adobe-creative-cloud.md +0 -605
  38. package/src/installs/appcleaner.js +0 -321
  39. package/src/installs/appcleaner.md +0 -699
  40. package/src/installs/apt-transport-https.js +0 -390
  41. package/src/installs/apt-transport-https.md +0 -678
  42. package/src/installs/atomicparsley.js +0 -642
  43. package/src/installs/atomicparsley.md +0 -795
  44. package/src/installs/aws-cli.js +0 -797
  45. package/src/installs/aws-cli.md +0 -727
  46. package/src/installs/balena-etcher.js +0 -710
  47. package/src/installs/balena-etcher.md +0 -761
  48. package/src/installs/bambu-studio.js +0 -1143
  49. package/src/installs/bambu-studio.md +0 -780
  50. package/src/installs/bash-completion.js +0 -575
  51. package/src/installs/bash-completion.md +0 -833
  52. package/src/installs/bash.js +0 -417
  53. package/src/installs/bash.md +0 -993
  54. package/src/installs/beyond-compare.js +0 -603
  55. package/src/installs/beyond-compare.md +0 -813
  56. package/src/installs/brave-browser.js +0 -968
  57. package/src/installs/brave-browser.md +0 -650
  58. package/src/installs/build-essential.js +0 -529
  59. package/src/installs/build-essential.md +0 -977
  60. package/src/installs/ca-certificates.js +0 -618
  61. package/src/installs/ca-certificates.md +0 -937
  62. package/src/installs/caffeine.js +0 -508
  63. package/src/installs/caffeine.md +0 -839
  64. package/src/installs/camtasia.js +0 -596
  65. package/src/installs/camtasia.md +0 -762
  66. package/src/installs/chatgpt.js +0 -476
  67. package/src/installs/chatgpt.md +0 -814
  68. package/src/installs/chocolatey.js +0 -456
  69. package/src/installs/chocolatey.md +0 -661
  70. package/src/installs/chrome-canary.js +0 -419
  71. package/src/installs/chrome-canary.md +0 -641
  72. package/src/installs/chromium.js +0 -667
  73. package/src/installs/chromium.md +0 -838
  74. package/src/installs/claude-code.js +0 -576
  75. package/src/installs/claude-code.md +0 -1173
  76. package/src/installs/cloudflare-warp.js +0 -900
  77. package/src/installs/cloudflare-warp.md +0 -1047
  78. package/src/installs/comet-browser.js +0 -588
  79. package/src/installs/comet-browser.md +0 -731
  80. package/src/installs/curl.js +0 -379
  81. package/src/installs/curl.md +0 -714
  82. package/src/installs/cursor.js +0 -579
  83. package/src/installs/cursor.md +0 -970
  84. package/src/installs/dbeaver.js +0 -924
  85. package/src/installs/dbeaver.md +0 -939
  86. package/src/installs/dbschema.js +0 -692
  87. package/src/installs/dbschema.md +0 -925
  88. package/src/installs/dependencies.md +0 -453
  89. package/src/installs/development-tools.js +0 -600
  90. package/src/installs/development-tools.md +0 -977
  91. package/src/installs/docker.js +0 -1029
  92. package/src/installs/docker.md +0 -1109
  93. package/src/installs/drawio.js +0 -1019
  94. package/src/installs/drawio.md +0 -795
  95. package/src/installs/elmedia-player.js +0 -347
  96. package/src/installs/elmedia-player.md +0 -556
  97. package/src/installs/ffmpeg.js +0 -889
  98. package/src/installs/ffmpeg.md +0 -852
  99. package/src/installs/file.js +0 -464
  100. package/src/installs/file.md +0 -987
  101. package/src/installs/gemini-cli.js +0 -811
  102. package/src/installs/gemini-cli.md +0 -1153
  103. package/src/installs/git.js +0 -400
  104. package/src/installs/git.md +0 -907
  105. package/src/installs/gitego.js +0 -949
  106. package/src/installs/gitego.md +0 -1172
  107. package/src/installs/go.js +0 -931
  108. package/src/installs/go.md +0 -958
  109. package/src/installs/google-antigravity.js +0 -913
  110. package/src/installs/google-antigravity.md +0 -1075
  111. package/src/installs/google-chrome.js +0 -833
  112. package/src/installs/google-chrome.md +0 -862
  113. package/src/installs/gpg.js +0 -480
  114. package/src/installs/gpg.md +0 -1056
  115. package/src/installs/homebrew.js +0 -1028
  116. package/src/installs/homebrew.md +0 -988
  117. package/src/installs/imageoptim.js +0 -968
  118. package/src/installs/imageoptim.md +0 -1119
  119. package/src/installs/installers.json +0 -4032
  120. package/src/installs/installers.json.tmp +0 -3953
  121. package/src/installs/jq.js +0 -400
  122. package/src/installs/jq.md +0 -809
  123. package/src/installs/keyboard-maestro.js +0 -719
  124. package/src/installs/keyboard-maestro.md +0 -825
  125. package/src/installs/kiro.js +0 -864
  126. package/src/installs/kiro.md +0 -1015
  127. package/src/installs/latex.js +0 -789
  128. package/src/installs/latex.md +0 -1095
  129. package/src/installs/lftp.js +0 -356
  130. package/src/installs/lftp.md +0 -907
  131. package/src/installs/lsb-release.js +0 -346
  132. package/src/installs/lsb-release.md +0 -814
  133. package/src/installs/messenger.js +0 -847
  134. package/src/installs/messenger.md +0 -900
  135. package/src/installs/microsoft-office.js +0 -568
  136. package/src/installs/microsoft-office.md +0 -760
  137. package/src/installs/microsoft-teams.js +0 -801
  138. package/src/installs/microsoft-teams.md +0 -886
  139. package/src/installs/moom.js +0 -326
  140. package/src/installs/moom.md +0 -570
  141. package/src/installs/node.js +0 -904
  142. package/src/installs/node.md +0 -1153
  143. package/src/installs/nordpass.js +0 -716
  144. package/src/installs/nordpass.md +0 -921
  145. package/src/installs/nordvpn.js +0 -892
  146. package/src/installs/nordvpn.md +0 -1052
  147. package/src/installs/nvm.js +0 -995
  148. package/src/installs/nvm.md +0 -1057
  149. package/src/installs/ohmyzsh.js +0 -529
  150. package/src/installs/ohmyzsh.md +0 -1094
  151. package/src/installs/openssh.js +0 -804
  152. package/src/installs/openssh.md +0 -1056
  153. package/src/installs/pandoc.js +0 -662
  154. package/src/installs/pandoc.md +0 -1036
  155. package/src/installs/parallels-desktop.js +0 -431
  156. package/src/installs/parallels-desktop.md +0 -446
  157. package/src/installs/pinentry.js +0 -510
  158. package/src/installs/pinentry.md +0 -1142
  159. package/src/installs/pngyu.js +0 -869
  160. package/src/installs/pngyu.md +0 -896
  161. package/src/installs/postman.js +0 -799
  162. package/src/installs/postman.md +0 -940
  163. package/src/installs/procps.js +0 -425
  164. package/src/installs/procps.md +0 -851
  165. package/src/installs/safari-tech-preview.js +0 -374
  166. package/src/installs/safari-tech-preview.md +0 -533
  167. package/src/installs/sfnt2woff.js +0 -658
  168. package/src/installs/sfnt2woff.md +0 -795
  169. package/src/installs/shellcheck.js +0 -481
  170. package/src/installs/shellcheck.md +0 -1005
  171. package/src/installs/slack.js +0 -741
  172. package/src/installs/slack.md +0 -865
  173. package/src/installs/snagit.js +0 -585
  174. package/src/installs/snagit.md +0 -844
  175. package/src/installs/software-properties-common.js +0 -372
  176. package/src/installs/software-properties-common.md +0 -805
  177. package/src/installs/spotify.js +0 -877
  178. package/src/installs/spotify.md +0 -901
  179. package/src/installs/studio-3t.js +0 -823
  180. package/src/installs/studio-3t.md +0 -918
  181. package/src/installs/sublime-text.js +0 -804
  182. package/src/installs/sublime-text.md +0 -914
  183. package/src/installs/superwhisper.js +0 -706
  184. package/src/installs/superwhisper.md +0 -630
  185. package/src/installs/tailscale.js +0 -745
  186. package/src/installs/tailscale.md +0 -1100
  187. package/src/installs/tar.js +0 -389
  188. package/src/installs/tar.md +0 -946
  189. package/src/installs/termius.js +0 -798
  190. package/src/installs/termius.md +0 -844
  191. package/src/installs/terraform.js +0 -779
  192. package/src/installs/terraform.md +0 -899
  193. package/src/installs/tfenv.js +0 -778
  194. package/src/installs/tfenv.md +0 -1091
  195. package/src/installs/tidal.js +0 -771
  196. package/src/installs/tidal.md +0 -864
  197. package/src/installs/tmux.js +0 -346
  198. package/src/installs/tmux.md +0 -1030
  199. package/src/installs/tree.js +0 -411
  200. package/src/installs/tree.md +0 -833
  201. package/src/installs/unzip.js +0 -460
  202. package/src/installs/unzip.md +0 -879
  203. package/src/installs/vim.js +0 -421
  204. package/src/installs/vim.md +0 -1040
  205. package/src/installs/vlc.js +0 -821
  206. package/src/installs/vlc.md +0 -927
  207. package/src/installs/vscode.js +0 -843
  208. package/src/installs/vscode.md +0 -1002
  209. package/src/installs/wget.js +0 -420
  210. package/src/installs/wget.md +0 -791
  211. package/src/installs/whatsapp.js +0 -729
  212. package/src/installs/whatsapp.md +0 -854
  213. package/src/installs/winpty.js +0 -352
  214. package/src/installs/winpty.md +0 -620
  215. package/src/installs/woff2.js +0 -553
  216. package/src/installs/woff2.md +0 -977
  217. package/src/installs/wsl.js +0 -572
  218. package/src/installs/wsl.md +0 -699
  219. package/src/installs/xcode-clt.js +0 -520
  220. package/src/installs/xcode-clt.md +0 -351
  221. package/src/installs/xcode.js +0 -560
  222. package/src/installs/xcode.md +0 -573
  223. package/src/installs/yarn.js +0 -824
  224. package/src/installs/yarn.md +0 -1074
  225. package/src/installs/yq.js +0 -654
  226. package/src/installs/yq.md +0 -944
  227. package/src/installs/yt-dlp.js +0 -701
  228. package/src/installs/yt-dlp.md +0 -946
  229. package/src/installs/yum-utils.js +0 -297
  230. package/src/installs/yum-utils.md +0 -648
  231. package/src/installs/zoom.js +0 -759
  232. package/src/installs/zoom.md +0 -884
  233. package/src/installs/zsh.js +0 -455
  234. package/src/installs/zsh.md +0 -1008
  235. package/src/scripts/README.md +0 -617
  236. package/src/scripts/STATUS.md +0 -208
  237. package/src/scripts/afk.js +0 -411
  238. package/src/scripts/backup-all.js +0 -746
  239. package/src/scripts/backup-source.js +0 -727
  240. package/src/scripts/brewd.js +0 -389
  241. package/src/scripts/brewi.js +0 -520
  242. package/src/scripts/brewr.js +0 -527
  243. package/src/scripts/brews.js +0 -477
  244. package/src/scripts/brewu.js +0 -504
  245. package/src/scripts/c.js +0 -201
  246. package/src/scripts/ccurl.js +0 -341
  247. package/src/scripts/certbot-crontab-init.js +0 -504
  248. package/src/scripts/certbot-init.js +0 -657
  249. package/src/scripts/ch.js +0 -355
  250. package/src/scripts/claude-danger.js +0 -268
  251. package/src/scripts/clean-dev.js +0 -435
  252. package/src/scripts/clear-dns-cache.js +0 -541
  253. package/src/scripts/clone.js +0 -435
  254. package/src/scripts/code-all.js +0 -437
  255. package/src/scripts/count-files.js +0 -211
  256. package/src/scripts/count-folders.js +0 -211
  257. package/src/scripts/count.js +0 -264
  258. package/src/scripts/d.js +0 -219
  259. package/src/scripts/datauri.js +0 -389
  260. package/src/scripts/delete-files.js +0 -380
  261. package/src/scripts/docker-clean.js +0 -426
  262. package/src/scripts/dp.js +0 -442
  263. package/src/scripts/e.js +0 -390
  264. package/src/scripts/empty-trash.js +0 -513
  265. package/src/scripts/evm.js +0 -444
  266. package/src/scripts/fetch-github-repos.js +0 -456
  267. package/src/scripts/get-channel.js +0 -345
  268. package/src/scripts/get-course.js +0 -399
  269. package/src/scripts/get-dependencies.js +0 -306
  270. package/src/scripts/get-folder.js +0 -799
  271. package/src/scripts/get-tunes.js +0 -426
  272. package/src/scripts/get-video.js +0 -367
  273. package/src/scripts/git-backup.js +0 -577
  274. package/src/scripts/git-clone.js +0 -493
  275. package/src/scripts/git-pup.js +0 -319
  276. package/src/scripts/git-push.js +0 -396
  277. package/src/scripts/h.js +0 -622
  278. package/src/scripts/hide-desktop-icons.js +0 -499
  279. package/src/scripts/hide-hidden-files.js +0 -538
  280. package/src/scripts/install-dependencies-from.js +0 -456
  281. package/src/scripts/ips.js +0 -663
  282. package/src/scripts/iso.js +0 -370
  283. package/src/scripts/killni.js +0 -577
  284. package/src/scripts/ll.js +0 -467
  285. package/src/scripts/local-ip.js +0 -325
  286. package/src/scripts/m.js +0 -524
  287. package/src/scripts/map.js +0 -309
  288. package/src/scripts/mkd.js +0 -351
  289. package/src/scripts/ncu-update-all.js +0 -457
  290. package/src/scripts/nginx-init.js +0 -718
  291. package/src/scripts/npmi.js +0 -382
  292. package/src/scripts/o.js +0 -511
  293. package/src/scripts/org-by-date.js +0 -338
  294. package/src/scripts/p.js +0 -224
  295. package/src/scripts/packages.js +0 -330
  296. package/src/scripts/path.js +0 -225
  297. package/src/scripts/ports.js +0 -597
  298. package/src/scripts/q.js +0 -305
  299. package/src/scripts/refresh-files.js +0 -394
  300. package/src/scripts/remove-smaller-files.js +0 -516
  301. package/src/scripts/rename-files-with-date.js +0 -533
  302. package/src/scripts/resize-image.js +0 -539
  303. package/src/scripts/rm-safe.js +0 -669
  304. package/src/scripts/s.js +0 -540
  305. package/src/scripts/set-git-public.js +0 -365
  306. package/src/scripts/show-desktop-icons.js +0 -475
  307. package/src/scripts/show-hidden-files.js +0 -472
  308. package/src/scripts/tpa.js +0 -280
  309. package/src/scripts/tpo.js +0 -280
  310. package/src/scripts/u.js +0 -505
  311. package/src/scripts/vpush.js +0 -437
  312. package/src/scripts/y.js +0 -283
  313. package/src/utils/README.md +0 -95
  314. package/src/utils/common/apps.js +0 -143
  315. package/src/utils/common/display.js +0 -157
  316. package/src/utils/common/network.js +0 -185
  317. package/src/utils/common/os.js +0 -294
  318. package/src/utils/common/package-manager.js +0 -301
  319. package/src/utils/common/privileges.js +0 -138
  320. package/src/utils/common/shell.js +0 -261
  321. package/src/utils/macos/apps.js +0 -228
  322. package/src/utils/macos/brew.js +0 -315
  323. package/src/utils/ubuntu/apt.js +0 -307
  324. package/src/utils/ubuntu/desktop.js +0 -292
  325. package/src/utils/ubuntu/snap.js +0 -344
  326. package/src/utils/ubuntu/systemd.js +0 -286
  327. package/src/utils/windows/choco.js +0 -465
  328. package/src/utils/windows/env.js +0 -246
  329. package/src/utils/windows/registry.js +0 -269
  330. package/src/utils/windows/shell.js +0 -240
  331. package/src/utils/windows/winget.js +0 -489
@@ -1,851 +0,0 @@
1
- # Installing procps
2
-
3
- ## Dependencies
4
-
5
- ### macOS (Homebrew)
6
- - **Required:** None
7
- - **Optional:** None
8
- - **Auto-installed:** None
9
- - **Note:** procps is a Linux-specific package that relies on the `/proc` filesystem which does not exist on macOS. macOS provides equivalent functionality through built-in commands (`ps`, `top`, `vm_stat`) and Activity Monitor. See the macOS section below for details on native alternatives.
10
-
11
- ### Ubuntu (APT/Snap)
12
- - **Required:** None (APT is built into Ubuntu/Debian)
13
- - **Optional:** None
14
- - **Auto-installed:** `libncursesw6`, `libproc2-0` (or `libprocps8` on older versions), `libtinfo6` (installed automatically by APT as procps dependencies)
15
-
16
- ### Raspberry Pi OS (APT/Snap)
17
- - **Required:** None (APT is built into Raspberry Pi OS)
18
- - **Optional:** None
19
- - **Auto-installed:** `libncursesw6`, `libproc2-0` (or `libprocps8` on older versions), `libtinfo6` (installed automatically by APT as procps dependencies)
20
-
21
- ### Amazon Linux (DNF/YUM)
22
- - **Required:** None (DNF/YUM is built into Amazon Linux)
23
- - **Optional:** None
24
- - **Auto-installed:** `ncurses-libs` (installed automatically by DNF/YUM as procps-ng dependencies)
25
- - **Note:** On RHEL-based systems (including Amazon Linux), the package is named `procps-ng` rather than `procps`
26
-
27
- ### Windows (Chocolatey/winget)
28
- - **Required:** None
29
- - **Optional:** None
30
- - **Auto-installed:** None
31
- - **Note:** procps is a Linux-specific package. Windows provides equivalent functionality through built-in PowerShell cmdlets (`Get-Process`, `Get-Counter`) and Task Manager. For command-line alternatives, see the Windows section below which covers Sysinternals PsTools.
32
-
33
- ### Git Bash (Manual/Portable)
34
- - **Required:** None
35
- - **Optional:** None
36
- - **Auto-installed:** None
37
- - **Note:** procps is a Linux-specific package. Git Bash on Windows does not support procps. Use Windows native tools or WSL for Linux-compatible process utilities.
38
-
39
- ## Overview
40
-
41
- procps (or procps-ng, the "next generation" fork) is a collection of command-line utilities for monitoring system processes and resources on Linux systems. These utilities read information from the `/proc` pseudo-filesystem, which the Linux kernel dynamically generates to expose process and system information.
42
-
43
- The procps package is essential for system administration and includes these core utilities:
44
-
45
- | Utility | Description |
46
- |---------|-------------|
47
- | `ps` | Display a snapshot of current processes |
48
- | `top` | Interactive real-time process viewer |
49
- | `free` | Display memory usage (total, used, free, shared, buffers, cache) |
50
- | `vmstat` | Report virtual memory statistics |
51
- | `pgrep` | Find processes by name or attributes |
52
- | `pkill` | Send signals to processes by name or attributes |
53
- | `pmap` | Display memory map of a process |
54
- | `pwdx` | Print working directory of a process |
55
- | `slabtop` | Display kernel slab cache information in real time |
56
- | `sysctl` | Read and modify kernel parameters at runtime |
57
- | `tload` | Graphical representation of system load average |
58
- | `uptime` | Show how long the system has been running |
59
- | `w` | Show who is logged in and what they are doing |
60
- | `watch` | Execute a command periodically and display output |
61
- | `pidof` | Find the process ID of a running program |
62
- | `kill` | Send signals to processes by PID |
63
- | `skill` | Send signals to processes by name (obsolete, use `pkill`) |
64
- | `snice` | Adjust process priority by name (obsolete, use `pkill`) |
65
-
66
- **Important**: procps is Linux-specific and requires the `/proc` filesystem. It is not available on macOS or Windows. These platforms have their own native process monitoring tools, documented in their respective sections below.
67
-
68
- ## Prerequisites
69
-
70
- Before installing procps on Linux platforms, ensure:
71
-
72
- 1. **Internet connectivity** - Required to download packages from repositories
73
- 2. **Administrative privileges** - Required for system-wide installation via `sudo`
74
- 3. **Linux operating system** - procps only works on Linux; it will not function on macOS, Windows, or BSD systems
75
-
76
- **Note**: procps is typically pre-installed on most Linux distributions as it contains essential system utilities. The installation steps below ensure procps is installed or update it to the latest version.
77
-
78
- ## Platform-Specific Installation
79
-
80
- ### macOS (Homebrew)
81
-
82
- #### Platform Compatibility Notice
83
-
84
- procps is **not available on macOS**. The procps utilities are designed specifically for Linux and rely on the `/proc` filesystem, which does not exist on macOS. macOS uses a different kernel architecture (XNU/Darwin) that exposes process information through different mechanisms.
85
-
86
- #### Native Alternatives
87
-
88
- macOS provides equivalent functionality through built-in commands. No installation is required:
89
-
90
- | procps Utility | macOS Equivalent | Description |
91
- |----------------|------------------|-------------|
92
- | `ps` | `ps` | Process status (BSD variant, slightly different options) |
93
- | `top` | `top` | Interactive process viewer (press `q` to quit) |
94
- | `free` | `vm_stat` | Virtual memory statistics (different output format) |
95
- | `vmstat` | `vm_stat` | Virtual memory statistics |
96
- | `pgrep` | `pgrep` | Find processes by name |
97
- | `pkill` | `pkill` | Kill processes by name |
98
- | `uptime` | `uptime` | System uptime |
99
- | `w` | `w` | Who is logged in |
100
- | `watch` | Install via `brew install --quiet watch` | Periodic command execution |
101
- | `kill` | `kill` | Send signals to processes |
102
-
103
- #### Installation Steps (watch utility only)
104
-
105
- The only procps utility not natively available on macOS is `watch`. Install it via Homebrew:
106
-
107
- ```bash
108
- brew install --quiet watch
109
- ```
110
-
111
- The `--quiet` flag suppresses non-essential output for automation compatibility.
112
-
113
- #### Verification
114
-
115
- Verify native macOS utilities are available:
116
-
117
- ```bash
118
- ps --version 2>&1 | head -1 || ps aux | head -1
119
- ```
120
-
121
- Check the `watch` utility if installed:
122
-
123
- ```bash
124
- watch --version
125
- ```
126
-
127
- Expected output (version numbers may vary):
128
-
129
- ```
130
- watch from procps-ng 4.0.4
131
- ```
132
-
133
- #### Alternative: Activity Monitor
134
-
135
- For graphical process monitoring, use Activity Monitor:
136
-
137
- ```bash
138
- open -a "Activity Monitor"
139
- ```
140
-
141
- ---
142
-
143
- ### Ubuntu/Debian (APT)
144
-
145
- #### Prerequisites
146
-
147
- - Ubuntu 18.04 LTS or later, or Debian 10 (Buster) or later
148
- - sudo privileges
149
- - Internet connectivity
150
-
151
- procps is typically pre-installed on Ubuntu and Debian systems. The steps below ensure it is installed or update it to the latest version.
152
-
153
- #### Installation Steps
154
-
155
- Run the following command to install procps:
156
-
157
- ```bash
158
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y procps
159
- ```
160
-
161
- The `DEBIAN_FRONTEND=noninteractive` environment variable and `-y` flag ensure fully automated installation without prompts.
162
-
163
- #### Verification
164
-
165
- Confirm the installation succeeded by checking multiple utilities:
166
-
167
- ```bash
168
- ps --version
169
- ```
170
-
171
- Expected output (version numbers may vary):
172
-
173
- ```
174
- ps from procps-ng 4.0.4
175
- ```
176
-
177
- Verify other key utilities:
178
-
179
- ```bash
180
- free --version
181
- ```
182
-
183
- Expected output:
184
-
185
- ```
186
- free from procps-ng 4.0.4
187
- ```
188
-
189
- Test the utilities work correctly:
190
-
191
- ```bash
192
- # Show process list
193
- ps aux | head -5
194
-
195
- # Show memory usage
196
- free -h
197
-
198
- # Show system uptime
199
- uptime
200
- ```
201
-
202
- #### Troubleshooting
203
-
204
- **Problem**: `E: Unable to locate package procps`
205
-
206
- **Solution**: Update the package list first:
207
-
208
- ```bash
209
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
210
- ```
211
-
212
- **Problem**: `ps: command not found` after installation
213
-
214
- **Solution**: The PATH may not include `/usr/bin`. Verify the installation location:
215
-
216
- ```bash
217
- which ps
218
- dpkg -L procps | grep bin
219
- ```
220
-
221
- **Problem**: Old version of procps
222
-
223
- **Solution**: Ubuntu and Debian repositories maintain stable versions. The installed version depends on your distribution release. To check your version:
224
-
225
- ```bash
226
- apt-cache policy procps
227
- ```
228
-
229
- ---
230
-
231
- ### Raspberry Pi OS (APT)
232
-
233
- #### Prerequisites
234
-
235
- - Raspberry Pi OS (32-bit or 64-bit) - Bookworm or Bullseye
236
- - Raspberry Pi 2 or later
237
- - sudo privileges
238
- - Internet connectivity
239
-
240
- Raspberry Pi OS is based on Debian, so procps installation follows the same process as Ubuntu/Debian. procps is typically pre-installed on Raspberry Pi OS.
241
-
242
- #### Installation Steps
243
-
244
- Run the following command to install procps:
245
-
246
- ```bash
247
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y procps
248
- ```
249
-
250
- The `DEBIAN_FRONTEND=noninteractive` environment variable and `-y` flag ensure fully automated installation without prompts.
251
-
252
- #### Verification
253
-
254
- Confirm the installation succeeded:
255
-
256
- ```bash
257
- ps --version
258
- ```
259
-
260
- Expected output for ARM (version numbers may vary):
261
-
262
- ```
263
- ps from procps-ng 4.0.4
264
- ```
265
-
266
- Verify your architecture:
267
-
268
- ```bash
269
- uname -m
270
- ```
271
-
272
- Expected output: `aarch64` (64-bit) or `armv7l` (32-bit).
273
-
274
- Test key utilities work correctly:
275
-
276
- ```bash
277
- # Show memory usage (useful for monitoring Pi resources)
278
- free -h
279
-
280
- # Show top processes by CPU
281
- top -bn1 | head -15
282
-
283
- # Show system load
284
- uptime
285
- ```
286
-
287
- #### Troubleshooting
288
-
289
- **Problem**: `top` shows incorrect CPU count on multi-core Pi
290
-
291
- **Solution**: This is expected behavior. Verify CPU count with:
292
-
293
- ```bash
294
- nproc
295
- ```
296
-
297
- **Problem**: `free` shows very little available memory
298
-
299
- **Solution**: On Raspberry Pi with limited RAM, this is normal. The kernel uses available memory for caching. Check the "available" column for actual usable memory:
300
-
301
- ```bash
302
- free -h
303
- ```
304
-
305
- **Problem**: Installation fails with disk space errors
306
-
307
- **Solution**: Check available disk space and clean up if needed:
308
-
309
- ```bash
310
- df -h
311
- sudo DEBIAN_FRONTEND=noninteractive apt-get autoremove -y
312
- sudo DEBIAN_FRONTEND=noninteractive apt-get clean
313
- ```
314
-
315
- ---
316
-
317
- ### Amazon Linux (DNF/YUM)
318
-
319
- #### Prerequisites
320
-
321
- - Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
322
- - sudo privileges
323
- - Internet connectivity
324
-
325
- **Important**: On RHEL-based systems including Amazon Linux, the package is named `procps-ng` (next generation) rather than `procps`. Amazon Linux 2023 uses `dnf` as the package manager, while Amazon Linux 2 uses `yum`. AWS creates a symlink so `yum` commands also work on AL2023.
326
-
327
- procps-ng is typically pre-installed on Amazon Linux.
328
-
329
- #### Installation Steps
330
-
331
- **For Amazon Linux 2023:**
332
-
333
- Run the following command to install procps-ng:
334
-
335
- ```bash
336
- sudo dnf install -y procps-ng
337
- ```
338
-
339
- **For Amazon Linux 2:**
340
-
341
- Run the following command to install procps-ng:
342
-
343
- ```bash
344
- sudo yum install -y procps-ng
345
- ```
346
-
347
- The `-y` flag automatically confirms installation prompts, enabling non-interactive execution.
348
-
349
- #### Verification
350
-
351
- Confirm the installation succeeded:
352
-
353
- ```bash
354
- ps --version
355
- ```
356
-
357
- Expected output (version numbers may vary):
358
-
359
- ```
360
- ps from procps-ng 3.3.17
361
- ```
362
-
363
- Verify other utilities:
364
-
365
- ```bash
366
- free --version
367
- vmstat --version
368
- ```
369
-
370
- Check which package provides the utilities:
371
-
372
- ```bash
373
- rpm -qf /usr/bin/ps
374
- ```
375
-
376
- Expected output: `procps-ng-<version>`
377
-
378
- Test the utilities work correctly:
379
-
380
- ```bash
381
- # Show memory in human-readable format
382
- free -h
383
-
384
- # Show virtual memory statistics
385
- vmstat 1 3
386
-
387
- # Show system uptime and load average
388
- uptime
389
- ```
390
-
391
- #### Troubleshooting
392
-
393
- **Problem**: `No match for argument: procps`
394
-
395
- **Solution**: On Amazon Linux, the package is named `procps-ng`, not `procps`:
396
-
397
- ```bash
398
- sudo dnf install -y procps-ng
399
- ```
400
-
401
- **Problem**: `dnf: command not found` on Amazon Linux 2
402
-
403
- **Solution**: Use `yum` instead of `dnf` on Amazon Linux 2:
404
-
405
- ```bash
406
- sudo yum install -y procps-ng
407
- ```
408
-
409
- **Problem**: Utilities are available but `--version` flag not recognized
410
-
411
- **Solution**: Some older versions may not support `--version`. Test functionality directly:
412
-
413
- ```bash
414
- ps aux | head -5
415
- free -m
416
- ```
417
-
418
- ---
419
-
420
- ### Windows (Chocolatey/winget)
421
-
422
- #### Platform Compatibility Notice
423
-
424
- procps is **not available on Windows**. The procps utilities are designed specifically for Linux and require the `/proc` filesystem, which does not exist on Windows. Windows uses a completely different process and memory management architecture.
425
-
426
- #### Native Alternatives
427
-
428
- Windows provides equivalent functionality through built-in tools and Microsoft Sysinternals utilities:
429
-
430
- | procps Utility | Windows Equivalent | Description |
431
- |----------------|-------------------|-------------|
432
- | `ps` | `Get-Process` (PowerShell) or `tasklist` (CMD) | List running processes |
433
- | `top` | Task Manager or `Get-Process \| Sort-Object CPU -Descending` | Interactive process viewer |
434
- | `free` | `systeminfo` or `Get-CimInstance Win32_OperatingSystem` | Memory information |
435
- | `vmstat` | `typeperf` or Performance Monitor | System statistics |
436
- | `pgrep` | `Get-Process -Name <name>` | Find processes by name |
437
- | `pkill` | `Stop-Process -Name <name>` | Kill processes by name |
438
- | `uptime` | `systeminfo \| findstr "Boot Time"` or `(Get-CimInstance Win32_OperatingSystem).LastBootUpTime` | System uptime |
439
- | `kill` | `taskkill /PID <pid>` or `Stop-Process -Id <pid>` | Kill process by PID |
440
-
441
- #### Installation Steps (Sysinternals PsTools)
442
-
443
- For command-line utilities similar to procps, install Microsoft Sysinternals PsTools:
444
-
445
- ```powershell
446
- choco install pstools -y
447
- ```
448
-
449
- The `-y` flag automatically confirms all prompts for non-interactive installation.
450
-
451
- PsTools includes:
452
-
453
- | Utility | Description |
454
- |---------|-------------|
455
- | `PsList` | List detailed process information (similar to `ps`) |
456
- | `PsKill` | Kill processes by name or PID |
457
- | `PsInfo` | List system information |
458
- | `PsService` | View and control services |
459
- | `PsExec` | Execute processes remotely |
460
-
461
- #### Verification
462
-
463
- Verify PsTools installation:
464
-
465
- ```powershell
466
- pslist -?
467
- ```
468
-
469
- Test native Windows process commands in PowerShell:
470
-
471
- ```powershell
472
- # List all processes (similar to ps aux)
473
- Get-Process | Select-Object -First 10
474
-
475
- # Show memory information (similar to free)
476
- Get-CimInstance Win32_OperatingSystem | Select-Object TotalVisibleMemorySize, FreePhysicalMemory
477
-
478
- # Show system uptime
479
- (Get-Date) - (Get-CimInstance Win32_OperatingSystem).LastBootUpTime
480
- ```
481
-
482
- Test native Windows process commands in Command Prompt:
483
-
484
- ```cmd
485
- :: List all processes
486
- tasklist
487
-
488
- :: Show system information including memory
489
- systeminfo | findstr /C:"Total Physical Memory" /C:"Available Physical Memory"
490
- ```
491
-
492
- #### Troubleshooting
493
-
494
- **Problem**: `choco` command not found
495
-
496
- **Solution**: Install Chocolatey first. Run in an Administrator PowerShell:
497
-
498
- ```powershell
499
- Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
500
- ```
501
-
502
- **Problem**: PsTools commands not found after installation
503
-
504
- **Solution**: Open a new Command Prompt or PowerShell window for PATH updates to take effect.
505
-
506
- **Problem**: Need full Linux procps compatibility
507
-
508
- **Solution**: Use WSL (Windows Subsystem for Linux) to run actual procps utilities. See the WSL section below.
509
-
510
- ---
511
-
512
- ### WSL (Ubuntu)
513
-
514
- #### Prerequisites
515
-
516
- - Windows 10 version 2004 or higher, or Windows 11
517
- - Windows Subsystem for Linux (WSL) with Ubuntu installed
518
- - WSL 2 recommended for best performance
519
- - sudo privileges within WSL
520
-
521
- WSL provides a full Linux environment where procps works exactly as it does on native Linux, including access to the `/proc` filesystem.
522
-
523
- #### Installation Steps
524
-
525
- Open your WSL Ubuntu terminal and run:
526
-
527
- ```bash
528
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y procps
529
- ```
530
-
531
- The `DEBIAN_FRONTEND=noninteractive` environment variable and `-y` flag ensure fully automated installation without prompts.
532
-
533
- #### Verification
534
-
535
- Confirm the installation succeeded:
536
-
537
- ```bash
538
- ps --version
539
- ```
540
-
541
- Expected output (version numbers may vary):
542
-
543
- ```
544
- ps from procps-ng 4.0.4
545
- ```
546
-
547
- Verify the `/proc` filesystem is available (it should be in WSL 2):
548
-
549
- ```bash
550
- ls /proc | head -10
551
- ```
552
-
553
- Test key utilities:
554
-
555
- ```bash
556
- # Show memory usage
557
- free -h
558
-
559
- # Show process list
560
- ps aux | head -5
561
-
562
- # Show virtual memory statistics
563
- vmstat 1 3
564
-
565
- # Show system uptime
566
- uptime
567
- ```
568
-
569
- #### Troubleshooting
570
-
571
- **Problem**: `E: Unable to locate package procps`
572
-
573
- **Solution**: Update the package list first:
574
-
575
- ```bash
576
- sudo DEBIAN_FRONTEND=noninteractive apt-get update -y
577
- ```
578
-
579
- **Problem**: WSL itself is not installed
580
-
581
- **Solution**: Install WSL from an Administrator PowerShell on Windows:
582
-
583
- ```powershell
584
- wsl --install
585
- ```
586
-
587
- Restart your computer after installation.
588
-
589
- **Problem**: `/proc` filesystem shows limited information
590
-
591
- **Solution**: WSL 2 provides better `/proc` compatibility than WSL 1. Check your WSL version:
592
-
593
- ```bash
594
- # From WSL
595
- cat /proc/version
596
- ```
597
-
598
- Upgrade to WSL 2 if needed (from Windows PowerShell):
599
-
600
- ```powershell
601
- wsl --set-version Ubuntu 2
602
- ```
603
-
604
- **Problem**: `top` shows incorrect CPU/memory for Windows host
605
-
606
- **Solution**: In WSL, procps utilities show information about the WSL virtual machine, not the Windows host. This is expected behavior. For Windows host information, use native Windows tools.
607
-
608
- ---
609
-
610
- ### Git Bash (Manual/Portable)
611
-
612
- #### Platform Compatibility Notice
613
-
614
- procps is **not available for Git Bash**. Git Bash provides a minimal Unix-like environment on Windows but does not include a `/proc` filesystem or Linux process management capabilities. procps utilities cannot function without `/proc`.
615
-
616
- #### Native Alternatives
617
-
618
- Git Bash can access Windows native commands. Use these alternatives:
619
-
620
- | procps Utility | Git Bash Workaround | Notes |
621
- |----------------|---------------------|-------|
622
- | `ps` | `ps` (limited) or `tasklist.exe` | Git Bash includes a basic `ps` that shows bash processes |
623
- | `top` | `tasklist.exe /V` | No interactive equivalent; use Task Manager |
624
- | `free` | `systeminfo.exe \| grep Memory` | Different output format |
625
- | `kill` | `kill` or `taskkill.exe` | Git Bash `kill` works for bash processes |
626
- | `uptime` | No equivalent | Use `systeminfo.exe \| grep "Boot Time"` |
627
-
628
- #### Installation Steps
629
-
630
- No installation is possible. For full procps functionality on Windows, use one of these alternatives:
631
-
632
- **Option 1: Use WSL (Recommended)**
633
-
634
- WSL provides full Linux compatibility including procps. See the WSL section above.
635
-
636
- **Option 2: Use Windows native tools**
637
-
638
- Access Windows commands directly from Git Bash:
639
-
640
- ```bash
641
- # List processes
642
- tasklist.exe
643
-
644
- # Kill a process by name
645
- taskkill.exe /IM notepad.exe /F
646
-
647
- # Show system information
648
- systeminfo.exe
649
- ```
650
-
651
- **Option 3: Install Sysinternals PsTools on Windows**
652
-
653
- Install PsTools via Chocolatey (see Windows section), then access from Git Bash:
654
-
655
- ```bash
656
- pslist.exe
657
- ```
658
-
659
- #### Verification
660
-
661
- Verify the limited `ps` available in Git Bash:
662
-
663
- ```bash
664
- ps
665
- ```
666
-
667
- This shows only processes running within the Git Bash session.
668
-
669
- For Windows process information, use:
670
-
671
- ```bash
672
- tasklist.exe | head -10
673
- ```
674
-
675
- #### Troubleshooting
676
-
677
- **Problem**: `ps aux` returns empty or limited output
678
-
679
- **Solution**: This is expected. Git Bash's `ps` only shows processes in the current bash session. Use `tasklist.exe` for all Windows processes.
680
-
681
- **Problem**: Need full Linux process utilities
682
-
683
- **Solution**: Use WSL instead of Git Bash. WSL provides a complete Linux environment with full procps support.
684
-
685
- ---
686
-
687
- ## Post-Installation Configuration
688
-
689
- procps utilities work out of the box with sensible defaults. The following optional configurations may be useful:
690
-
691
- ### Customize top Display
692
-
693
- Create a configuration file for `top` to remember your preferred settings:
694
-
695
- ```bash
696
- # Run top, configure as desired (press 'W' to write config)
697
- top
698
- # Press 'z' for color
699
- # Press 'c' for full command line
700
- # Press '1' to show individual CPUs
701
- # Press 'Shift+W' to save configuration
702
- ```
703
-
704
- The configuration is saved to `~/.config/procps/toprc` or `~/.toprc`.
705
-
706
- ### Create Aliases for Common Commands
707
-
708
- Add useful aliases to your shell configuration (`~/.bashrc` or `~/.zshrc`):
709
-
710
- ```bash
711
- # Memory usage in human-readable format
712
- alias mem='free -h'
713
-
714
- # Show top 10 processes by CPU usage
715
- alias topcpu='ps aux --sort=-%cpu | head -11'
716
-
717
- # Show top 10 processes by memory usage
718
- alias topmem='ps aux --sort=-%mem | head -11'
719
-
720
- # Quick system overview
721
- alias sysinfo='echo "=== Uptime ===" && uptime && echo "=== Memory ===" && free -h && echo "=== Load ===" && vmstat 1 1'
722
- ```
723
-
724
- Reload your shell configuration:
725
-
726
- ```bash
727
- source ~/.bashrc
728
- ```
729
-
730
- ### Configure sysctl Parameters (Advanced)
731
-
732
- The `sysctl` utility (part of procps) can configure kernel parameters. Common configurations:
733
-
734
- ```bash
735
- # View all current settings
736
- sysctl -a 2>/dev/null | head -20
737
-
738
- # View a specific setting
739
- sysctl vm.swappiness
740
-
741
- # Temporarily change a setting (until reboot)
742
- sudo sysctl -w vm.swappiness=10
743
- ```
744
-
745
- For permanent changes, create a file in `/etc/sysctl.d/`:
746
-
747
- ```bash
748
- # Example: reduce swappiness
749
- echo 'vm.swappiness=10' | sudo tee /etc/sysctl.d/99-custom.conf
750
- sudo sysctl --system
751
- ```
752
-
753
- ---
754
-
755
- ## Common Issues
756
-
757
- ### Issue: "ps: command not found"
758
-
759
- **Symptoms**: Running `ps` returns "command not found" even on Linux.
760
-
761
- **Solution**: procps may not be installed (rare on standard installations). Install it:
762
-
763
- ```bash
764
- # Ubuntu/Debian/Raspberry Pi OS/WSL
765
- sudo DEBIAN_FRONTEND=noninteractive apt-get install -y procps
766
-
767
- # Amazon Linux
768
- sudo dnf install -y procps-ng
769
- ```
770
-
771
- ### Issue: "free" Shows Different Values Than Expected
772
-
773
- **Symptoms**: The `free` command shows low "free" memory even with no applications running.
774
-
775
- **Explanation**: This is normal Linux behavior. Linux uses available memory for disk caching to improve performance. Look at the "available" column (not "free") to see memory actually available for applications:
776
-
777
- ```bash
778
- free -h
779
- ```
780
-
781
- The "available" column shows memory that can be allocated to applications (including reclaimable cache).
782
-
783
- ### Issue: "top" Consumes High CPU
784
-
785
- **Symptoms**: The `top` command itself uses significant CPU.
786
-
787
- **Solution**: Increase the update interval to reduce CPU usage:
788
-
789
- ```bash
790
- # Update every 5 seconds instead of default 3
791
- top -d 5
792
- ```
793
-
794
- Or set a permanent default in `~/.toprc`.
795
-
796
- ### Issue: "vmstat" Shows Zeros for All Values
797
-
798
- **Symptoms**: Running `vmstat` shows all zeros.
799
-
800
- **Solution**: Run `vmstat` with an interval to see live statistics:
801
-
802
- ```bash
803
- # Show statistics every 1 second, 5 times
804
- vmstat 1 5
805
- ```
806
-
807
- The first line shows averages since boot; subsequent lines show current activity.
808
-
809
- ### Issue: "pgrep" or "pkill" Not Matching Processes
810
-
811
- **Symptoms**: `pgrep processname` returns nothing even though the process is running.
812
-
813
- **Solution**: pgrep matches against the process name (the executable name), not the full command line. To match against the full command line, use `-f`:
814
-
815
- ```bash
816
- # Match executable name only
817
- pgrep nginx
818
-
819
- # Match full command line
820
- pgrep -f "nginx -c /etc/nginx/nginx.conf"
821
- ```
822
-
823
- ### Issue: Permission Denied Reading /proc Files
824
-
825
- **Symptoms**: Some utilities show "Permission denied" or incomplete information.
826
-
827
- **Solution**: Certain `/proc` entries require root privileges. Run with `sudo`:
828
-
829
- ```bash
830
- sudo slabtop
831
- sudo vmstat -m
832
- ```
833
-
834
- ---
835
-
836
- ## References
837
-
838
- - [procps-ng Official GitLab Repository](https://gitlab.com/procps-ng/procps)
839
- - [procps-ng Releases](https://gitlab.com/procps-ng/procps/-/releases)
840
- - [Ubuntu procps Package](https://packages.ubuntu.com/search?keywords=procps)
841
- - [Debian procps Package](https://packages.debian.org/sid/procps)
842
- - [Fedora procps-ng Package](https://packages.fedoraproject.org/pkgs/procps-ng/procps-ng/)
843
- - [Red Hat procps Documentation](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/6/html/6.6_technical_notes/procps)
844
- - [Linux /proc Filesystem Documentation](https://www.kernel.org/doc/html/latest/filesystems/proc.html)
845
- - [ps(1) Manual Page](https://man7.org/linux/man-pages/man1/ps.1.html)
846
- - [top(1) Manual Page](https://man7.org/linux/man-pages/man1/top.1.html)
847
- - [free(1) Manual Page](https://man7.org/linux/man-pages/man1/free.1.html)
848
- - [vmstat(8) Manual Page](https://man7.org/linux/man-pages/man8/vmstat.8.html)
849
- - [Microsoft Sysinternals PsTools](https://learn.microsoft.com/en-us/sysinternals/downloads/pstools)
850
- - [Microsoft Process Explorer](https://learn.microsoft.com/en-us/sysinternals/downloads/process-explorer)
851
- - [Homebrew watch Formula](https://formulae.brew.sh/formula/watch)