{"_id":"psaux","_rev":"2906382","name":"psaux","description":"Display processes info in Node","dist-tags":{"latest":"0.4.0"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"time":{"modified":"2022-12-14T07:20:26.000Z","created":"2016-02-21T14:49:44.792Z","0.4.0":"2019-06-26T00:43:30.574Z","0.3.0":"2016-02-27T00:48:00.650Z","0.2.0":"2016-02-21T22:03:32.435Z","0.1.3":"2016-02-21T21:55:37.537Z","0.1.2":"2016-02-21T19:03:32.492Z","0.1.1":"2016-02-21T14:49:44.792Z"},"users":{},"author":{"name":"zzarcon"},"repository":{"type":"git","url":"git+https://github.com/zzarcon/psaux.git"},"versions":{"0.4.0":{"name":"psaux","version":"0.4.0","description":"Display processes info in Node","main":"index.js","scripts":{"test":"mocha --reporter spec --ui bdd --timeout 5000 test/*.js"},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"git+https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process","status"],"os":["darwin","freebsd","linux","win32"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"chai":"^3.5.0","mocha":"^2.4.5","relaser":"^0.2.0"},"gitHead":"4d40fdd71230dfadddeadc4a13395be88f695bc8","_id":"psaux@0.4.0","_npmVersion":"6.4.1","_nodeVersion":"10.13.0","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"dist":{"shasum":"b8ae9be22c1011cc227abb8b6e86e7dab11d055c","size":8055,"noattachment":false,"key":"/psaux/-/psaux-0.4.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.4.0.tgz"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/psaux_0.4.0_1561509810422_0.8435912375615751"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2021-12-20T05:25:18.768Z","publish_time":1561509810574,"_cnpm_publish_time":1561509810574},"0.3.0":{"name":"psaux","version":"0.3.0","description":"Display processes info in Node","main":"index.js","scripts":{"test":"mocha --reporter spec --ui bdd --timeout 5000 test/*.js"},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"git+https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process","status"],"os":["darwin","linux","win32"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"chai":"^3.5.0","mocha":"^2.4.5","relaser":"^0.2.0"},"gitHead":"3b7ffb0bdc62602c6b767ae52357b7eb0fe5b801","_id":"psaux@0.3.0","_shasum":"20bde191d2d8e950378ff541881a2094d01e3ab8","_from":".","_npmVersion":"2.14.2","_nodeVersion":"4.0.0","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"dist":{"shasum":"20bde191d2d8e950378ff541881a2094d01e3ab8","size":4709,"noattachment":false,"key":"/psaux/-/psaux-0.3.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.3.0.tgz"},"_npmOperationalInternal":{"host":"packages-6-west.internal.npmjs.com","tmp":"tmp/psaux-0.3.0.tgz_1456534077772_0.012225616490468383"},"directories":{},"_cnpmcore_publish_time":"2021-12-20T05:25:17.894Z","publish_time":1456534080650,"_cnpm_publish_time":1456534080650},"0.2.0":{"name":"psaux","version":"0.2.0","description":"Display processes info in Node","main":"index.js","scripts":{"test":"mocha --reporter spec --ui bdd --timeout 5000 test/*.js"},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"git+https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process","status"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"chai":"^3.5.0","mocha":"^2.4.5","relaser":"^0.2.0"},"gitHead":"b9b94379258c40f36cd95ff7e826b0736dee4fa7","_id":"psaux@0.2.0","_shasum":"8ca95e8b9f60408af1b644dbf3b6168beaa73c1f","_from":".","_npmVersion":"2.14.2","_nodeVersion":"4.0.0","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"dist":{"shasum":"8ca95e8b9f60408af1b644dbf3b6168beaa73c1f","size":3900,"noattachment":false,"key":"/psaux/-/psaux-0.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.2.0.tgz"},"_npmOperationalInternal":{"host":"packages-5-east.internal.npmjs.com","tmp":"tmp/psaux-0.2.0.tgz_1456092209513_0.3531225889455527"},"directories":{},"_cnpmcore_publish_time":"2021-12-20T05:25:17.034Z","publish_time":1456092212435,"_cnpm_publish_time":1456092212435},"0.1.3":{"name":"psaux","version":"0.1.3","description":"Display processes info in Node","main":"index.js","scripts":{"test":"mocha --reporter spec --ui bdd --timeout 5000 test/*.js"},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"git+https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process","status"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"chai":"^3.5.0","mocha":"^2.4.5","relaser":"^0.2.0"},"gitHead":"3525fe642c9535c11ce8e04e9c335cbfd4a45aec","_id":"psaux@0.1.3","_shasum":"bc30639a943f5f2bf4946013d0cd17ef7f77f28d","_from":".","_npmVersion":"2.14.2","_nodeVersion":"4.0.0","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"dist":{"shasum":"bc30639a943f5f2bf4946013d0cd17ef7f77f28d","size":3870,"noattachment":false,"key":"/psaux/-/psaux-0.1.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.1.3.tgz"},"_npmOperationalInternal":{"host":"packages-6-west.internal.npmjs.com","tmp":"tmp/psaux-0.1.3.tgz_1456091732404_0.10476010339334607"},"directories":{},"_cnpmcore_publish_time":"2021-12-20T05:25:16.159Z","publish_time":1456091737537,"_cnpm_publish_time":1456091737537},"0.1.2":{"name":"psaux","version":"0.1.2","description":"Display processes info in Node","main":"index.js","scripts":{"test":""},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"relaser":"^0.2.0"},"gitHead":"5e0bc29aecdbbb865d9f904c9eaf39becc482ca5","_id":"psaux@0.1.2","_shasum":"f683482ba52ac516a9e345bf5749e4267d0c46b4","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"dist":{"shasum":"f683482ba52ac516a9e345bf5749e4267d0c46b4","size":2435,"noattachment":false,"key":"/psaux/-/psaux-0.1.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.1.2.tgz"},"_npmOperationalInternal":{"host":"packages-9-west.internal.npmjs.com","tmp":"tmp/psaux-0.1.2.tgz_1456081407927_0.0011868961155414581"},"directories":{},"_cnpmcore_publish_time":"2021-12-20T05:25:15.265Z","publish_time":1456081412492,"_cnpm_publish_time":1456081412492},"0.1.1":{"name":"psaux","version":"0.1.1","description":"Display processes info in Node","main":"index.js","scripts":{"test":""},"engines":{"node":">=0.12"},"repository":{"type":"git","url":"https://github.com/zzarcon/psaux.git"},"keywords":["ps","aux","process"],"author":{"name":"zzarcon"},"license":"MIT","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"homepage":"https://github.com/zzarcon/psaux","dependencies":{"execa":"^0.2.2"},"devDependencies":{"relaser":"^0.2.0"},"gitHead":"358efaa86996a07019697277ba3f1e95dc0bf8da","_id":"psaux@0.1.1","_shasum":"bb515731c6c6853ef37f0992777dfb65705e055c","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"zzarcon","email":"hezarco@gmail.com"},"maintainers":[{"name":"zzarcon","email":"hezarco@gmail.com"}],"dist":{"shasum":"bb515731c6c6853ef37f0992777dfb65705e055c","size":1533,"noattachment":false,"key":"/psaux/-/psaux-0.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/psaux/download/psaux-0.1.1.tgz"},"_npmOperationalInternal":{"host":"packages-6-west.internal.npmjs.com","tmp":"tmp/psaux-0.1.1.tgz_1456066179948_0.5220986504573375"},"directories":{},"_cnpmcore_publish_time":"2021-12-20T05:25:14.374Z","publish_time":1456066184792,"_cnpm_publish_time":1456066184792}},"readme":"# psaux [![Build Status](https://travis-ci.org/zzarcon/psaux.svg?branch=master)](https://travis-ci.org/zzarcon/psaux) [![npm version](https://badge.fury.io/js/psaux.svg)](https://badge.fury.io/js/psaux) [![Dependency Status](https://david-dm.org/zzarcon/psaux.svg)](https://david-dm.org/zzarcon/psaux) [![npm license](https://img.shields.io/npm/l/awesome-badges.svg)](https://www.npmjs.org/package/awesome-badges)\n  > Process status in Node.js as you've always wanted\n\nPromise oriented and lightweight Javascript utility for getting info about the processes runing in your machine.\nIt is designed to give you a friendly api for filter within all of them.\n\n# Install\n\n`$ npm install psaux --save`\n\n# Usage \n\nDisplay the `user`, `pid`, `cpu` and `mem` of all the running processes:\n\n```javascript\nconst psaux = require('psaux');\n\npsaux().then(list => {  \n  list.forEach(ps => {\n    console.log(ps.user, ps.pid, ps.cpu, ps.mem);\n  });\n});\n```\n\nFind a concrete process using his **pid**\n\n```javascript\npsaux().then(list => {  \n  let chrome = list.query({pid: 12345});\n\n  console.log('Google chrome is using ' + chrome.cpu + '% of CPU and ' + chrome.mem + '% of memory');\n});\n\n```\nDisplay inefficient processes started from the `root` user.\n\n```javascript\npsaux().then(list => {  \n  let inefficient = list.query({\n    user: 'root',\n    mem: '>5'\n  });\n\n  console.log('Processes started by root and using more that 5% of memory');\n});\n```\n\nSearch for a process containing the passed string (very useful if you don't know the pid)\n\n```javascript\npsaux().then(list => {  \n  let chrome = list.query({command: '~chrome'});\n  \n  if (chrome) {\n    console.log('Chrome process found!', chrome);\n  }\n}); \n```\n\n# Filters\n\nYou can filter by every property of the returned objects using the **query** method. Also you can create complex filters if needed:\n\n```javascript\nlist.query({\n  user: 'john',\n  mem: '>2 <10',\n  vsz: '>4000000',\n  command: '~Sublime Text'\n});\n```\n\n* `>` Greater than: `>5`\n* `<` Lower than: `<5`\n* `~` Contains: `~Chrome`\n\n# Properties\n\nThe properties you can access are basically the same listed in the `ps` command:\n\n* **user**: user owning the process\n* **pid**: process ID\n* **cpu**: It is the CPU time used divided by the time the process has been running.\n* **mem**: ratio of the process’s resident set size to the physical memory on the machine\n* **vsz**: virtual memory usage of entire process (in KiB)\n* **rss**: resident set size, the non-swapped physical memory that a task has used (in KiB)\n* **tt**: controlling tty (terminal)\n* **stat**: multi-character process state\n* **started**: starting time or date of the process\n* **time**: cumulative CPU time\n* **command**: command with all its arguments\n\n# Supported platforms\n\nThe module currently supports Mac OS, Linux and Windows.\n","_attachments":{},"homepage":"https://github.com/zzarcon/psaux","bugs":{"url":"https://github.com/zzarcon/psaux/issues"},"license":"MIT"}