Skip to main content

List files opened by app (app.lsof)

Declaration​

files, err = app.lsof(bid_or_pid)

Parameters​

  • bid_or_pid
    String (bundle id) or Integer (pid).

Returns​

  • files
    Table | nil.

    On success returns a table with the structure below; on failure returns nil.
    {
        opensockets = {
            {
                fd = integer_value,
                kind = "TCP" | "IN",
                ["local"] = {
                    address = string_value,
                    port = integer_value,
                },
                ["remote"] = {
                    address = string_value,
                    port = integer_value,
                },
            },
            ...
        },
        openfiles = {
            {
                fd = integer_value,
                path = string_value,
            },
            ...
        },
    }

  • err
    String | nil. Error message when failed.

Notes​

  • List file descriptors and socket descriptors opened by the specified app.
  • Requires app version 1.3.8 or above.

Example​

nLog(app.lsof('com.apple.Preferences'))