@fredlackey/devutils 0.0.18 → 0.1.0

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 (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. 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)