find-process

WebJar for find-process

License	MIT
GroupId	org.webjars.npm
ArtifactId	find-process
Last Version	1.4.3
Release Date	Apr 5, 2020
Type	jar
Description	find-process WebJar for find-process
Project URL	https://www.webjars.org
Source Code Management	https://github.com/yibn2008/find-process

Download find-process

Filename	Size
find-process-1.4.3.pom
find-process-1.4.3.jar	13 KB
find-process-1.4.3-sources.jar	22 bytes
find-process-1.4.3-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/find-process/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>find-process</artifactId>
    <version>1.4.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/find-process/
implementation 'org.webjars.npm:find-process:1.4.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/find-process/
implementation ("org.webjars.npm:find-process:1.4.3")

Apache Buildr

'org.webjars.npm:find-process:jar:1.4.3'

Apache Ivy

<dependency org="org.webjars.npm" name="find-process" rev="1.4.3">
  <artifact name="find-process" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='find-process', version='1.4.3')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "find-process" % "1.4.3"

Leiningen

[org.webjars.npm/find-process "1.4.3"]

Dependencies

compile (3)

Group / Artifact	Type	Version
org.webjars.npm : chalk	jar	[2.0.1,3)
org.webjars.npm : commander	jar	[2.11.0,3)
org.webjars.npm : debug	jar	[2.6.8,3)

Project Modules

There are no modules declared in this project.

find-process

With find-process, you can:

• find the process which is listening specified port
• find the process by pid
• find the process by given name or name pattern

We have covered the difference of main OS platform, including Mac OSX, Linux, Windows and Android (with Termux).

CLI

Install find-process as a CLI tool:

$ npm install find-process -g

Usage:

  Usage: find-process [options] <keyword>


  Options:

    -V, --version      output the version number
    -t, --type <type>  find process by keyword type (pid|port|name)
    -p, --port         find process by port
    -h, --help         output usage information

  Examples:

    $ find-process node          # find by name "node"
    $ find-process 111           # find by pid "111"
    $ find-process -p 80         # find by port "80"
    $ find-process -t port 80    # find by port "80"

Example:

Node API

You can use npm to install:

$ npm install find-process --save

Usage:

const find = require('find-process');

find('pid', 12345)
  .then(function (list) {
    console.log(list);
  }, function (err) {
    console.log(err.stack || err);
  })

Synopsis

Promise<Array> find(type, value, [strict])

Arguments

• type the type of find, support: port|pid|name
• value the value of type, can be RegExp if type is name
• strict the optional strict mode is for checking port, pid, or name exactly matches the given one. (on Windows, .exe can be omitted)

Return

The return value of find-process is Promise, if you use co you can use yield find(type, value) directly.

The resolved value of promise is an array list of process ([] means it may be missing on some platforms):

[{
  pid: <process id>,
  ppid: [parent process id],
  uid: [user id (for *nix)],
  gid: [user group id (for *nix)],
  name: <command/process name>,
  bin: <execute path (for *nix)>,
  cmd: <full command with args>
}, ...]

Example

Find process which is listening port 80.

const find = require('find-process');

find('port', 80)
  .then(function (list) {
    if (!list.length) {
      console.log('port 80 is free now');
    } else {
      console.log('%s is listening port 80', list[0].name);
    }
  })

Find process by pid.

const find = require('find-process');

find('pid', 12345)
  .then(function (list) {
    console.log(list);
  }, function (err) {
    console.log(err.stack || err);
  });

Find all nginx process.

const find = require('find-process');

find('name', 'nginx', true)
  .then(function (list) {
    console.log('there are %s nginx process(es)', list.length);
  });

Contributing

We're welcome to receive Pull Request of bugfix or new feature, but please check the list before sending PR:

• Coding Style Please follow the Standard Style
• Documentation Add documentation for every API change
• Unit test Please add unit test for bugfix or new feature

License

MIT

Versions

Version
1.4.3 Apr 5, 2020