{
    "mode": "man",
    "parameter": "uptime",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/uptime/1/json",
    "generated": "2026-06-02T19:34:36Z",
    "synopsis": "uptime [options]",
    "sections": {
        "NAME": {
            "content": "uptime - Tell how long the system has been running.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "uptime [options]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "uptime gives a one line display of the following information.  The current time, how long the\nsystem has been running, how many users are currently logged on, and the system load averages\nfor the past 1, 5, and 15 minutes.\n\nThis is the same information contained in the header line displayed by w(1).\n\nSystem  load averages is the average number of processes that are either in a runnable or un‐\ninterruptable state.  A process in a runnable state is either using the CPU or waiting to use\nthe  CPU.   A process in uninterruptable state is waiting for some I/O access, eg waiting for\ndisk.  The averages are taken over the three time intervals.  Load averages are  not  normal‐\nized  for the number of CPUs in a system, so a load average of 1 means a single CPU system is\nloaded all the time while on a 4 CPU system it means it was idle 75% of the time.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-p --pretty",
                    "content": "show uptime in pretty format\n",
                    "flag": "-p",
                    "long": "--pretty"
                },
                {
                    "name": "-h --help",
                    "content": "display this help text\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-s --since",
                    "content": "system up since, in yyyy-mm-dd HH:MM:SS format\n",
                    "flag": "-s",
                    "long": "--since"
                },
                {
                    "name": "-V --version",
                    "content": "display version information and exit\n",
                    "flag": "-V",
                    "long": "--version"
                }
            ]
        },
        "FILES": {
            "content": "/var/run/utmp\ninformation about who is currently logged on\n\n/proc  process information\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "uptime was written by Larry Greenfield ⟨greenfie@gauss.rutgers.edu⟩ and  Michael  K.  Johnson\n⟨johnsonm@sunsite.unc.edu⟩\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "ps(1), top(1), utmp(5), w(1)\n",
            "subsections": []
        },
        "REPORTING BUGS": {
            "content": "Please send bug reports to ⟨procps@freelists.org⟩\n\n\n\nprocps-ng                                   December 2012                                  UPTIME(1)",
            "subsections": []
        }
    },
    "summary": "uptime - Tell how long the system has been running.",
    "flags": [
        {
            "flag": "-p",
            "long": "--pretty",
            "arg": null,
            "description": "show uptime in pretty format"
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "display this help text"
        },
        {
            "flag": "-s",
            "long": "--since",
            "arg": null,
            "description": "system up since, in yyyy-mm-dd HH:MM:SS format"
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "display version information and exit"
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "ps",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ps/1/json"
        },
        {
            "name": "top",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/top/1/json"
        },
        {
            "name": "utmp",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/utmp/5/json"
        },
        {
            "name": "w",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/w/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Tell how long the system has been running and other information.",
        "examples": [
            {
                "description": "Print current time, uptime, number of logged-in users, and other information",
                "command": "uptime"
            },
            {
                "description": "Show only the amount of time the system has been booted for",
                "command": "uptime {{-p|--pretty}}"
            },
            {
                "description": "Print the date and time the system booted up at",
                "command": "uptime {{-s|--since}}"
            },
            {
                "description": "Display the time data in seconds",
                "command": "uptime {{-r|--raw}}"
            },
            {
                "description": "Display version",
                "command": "uptime {{-V|--version}}"
            }
        ]
    }
}