{
    "mode": "man",
    "parameter": "rdisc",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/rdisc/8/json",
    "generated": "2026-06-16T03:25:43Z",
    "synopsis": "rdisc6 [-qv] [-r attempts] [-s sourceip] [-w waitms] [IPv6 address] <iface>",
    "sections": {
        "NAME": {
            "content": "rdisc - ICMPv6 Router Discovery tool\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "rdisc6 [-qv] [-r attempts] [-s sourceip] [-w waitms] [IPv6 address] <iface>\n\n",
            "subsections": []
        },
        "DESCRIPTON": {
            "content": "RDisc6  is  an  Unix  program which implements the ICMPv6 Router Discovery in userland (it is\nnormally done by the kernel). It is used to lookup the list of on-link routers and IPv6  pre‐\nfixes.\n\nIt  can  also  be used to force the kernel to update the state of a given IPv6-autoconfigured\nnetwork interface.\n\nThe name of the network interface to probe routers for must be specified.\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-1 --single",
                    "content": "Exit as soon as the first advertisement is received.\n\n",
                    "flag": "-1",
                    "long": "--single"
                },
                {
                    "name": "-h --help",
                    "content": "Display some help and exit.\n\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-m --multiple",
                    "content": "Wait for possible multiple advertisements and print all of them (default).\n\n",
                    "flag": "-m",
                    "long": "--multiple"
                },
                {
                    "name": "-n --numeric",
                    "content": "If the optional parameter is not a valid IPv6 address, do not try to resolve it  as  a\nDNS hostname.\n\n",
                    "flag": "-n",
                    "long": "--numeric"
                },
                {
                    "name": "-q --quiet",
                    "content": "Only  display  advertised  IPv6 prefixes. Display nothing in case of failure.  That is\nmostly useful when calling the program from a shell script.\n\n",
                    "flag": "-q",
                    "long": "--quiet"
                },
                {
                    "name": "-r --retry",
                    "content": "Send ICMPv6 Router Discovery that many times until a reply is received, or  abort.  By\ndefault, rdisc6 will try 3 times before aborting (MAXRTRSOLICITATIONS from RFC2461).\n\n",
                    "flag": "-r",
                    "long": "--retry"
                },
                {
                    "name": "-s --source",
                    "content": "Specify the IPv6 address to be used as the source for the router solicitation packets.\n\n",
                    "flag": "-s",
                    "long": "--source"
                },
                {
                    "name": "-V --version",
                    "content": "Display program version and license and exit.\n\n",
                    "flag": "-V",
                    "long": "--version"
                },
                {
                    "name": "-v --verbose",
                    "content": "Display verbose information. That is the default.\n\n",
                    "flag": "-v",
                    "long": "--verbose"
                },
                {
                    "name": "-w --wait",
                    "content": "Wait  waitms milliseconds for a response before retrying.  By default, rdisc6 waits 4\nsecond between each attempts (RTRSOLICITATIONINTERVAL from RFC2461).\n\n\nIf rdisc6 does not receive any response after the specified number of  attempts  waiting  for\nwaitms  milliseconds  each  time,  it will exit with code 2. On error, it exits with code 1.\nOtherwise it exits with code 0.\n\n",
                    "flag": "-w",
                    "long": "--wait"
                }
            ]
        },
        "SECURITY": {
            "content": "rdisc6 must be setuid root to allow use by non privileged users. It will drop its root privi‐\nleges  before any attempt is made to send or receive data from the network to reduce the pos‐\nsible impact of a security vulnerability.\n\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "ndisc6(8), ipv6(7)\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Rémi Denis-Courmont <remi at remlab dot net>\n\nhttp://www.remlab.net/ndisc6/\n\n\n\nrdisc6                                         $Date$                                      RDISC6(8)",
            "subsections": []
        }
    },
    "summary": "rdisc - ICMPv6 Router Discovery tool",
    "flags": [
        {
            "flag": "-1",
            "long": "--single",
            "arg": null,
            "description": "Exit as soon as the first advertisement is received."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Display some help and exit."
        },
        {
            "flag": "-m",
            "long": "--multiple",
            "arg": null,
            "description": "Wait for possible multiple advertisements and print all of them (default)."
        },
        {
            "flag": "-n",
            "long": "--numeric",
            "arg": null,
            "description": "If the optional parameter is not a valid IPv6 address, do not try to resolve it as a DNS hostname."
        },
        {
            "flag": "-q",
            "long": "--quiet",
            "arg": null,
            "description": "Only display advertised IPv6 prefixes. Display nothing in case of failure. That is mostly useful when calling the program from a shell script."
        },
        {
            "flag": "-r",
            "long": "--retry",
            "arg": null,
            "description": "Send ICMPv6 Router Discovery that many times until a reply is received, or abort. By default, rdisc6 will try 3 times before aborting (MAXRTRSOLICITATIONS from RFC2461)."
        },
        {
            "flag": "-s",
            "long": "--source",
            "arg": null,
            "description": "Specify the IPv6 address to be used as the source for the router solicitation packets."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Display program version and license and exit."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "Display verbose information. That is the default."
        },
        {
            "flag": "-w",
            "long": "--wait",
            "arg": null,
            "description": "Wait waitms milliseconds for a response before retrying. By default, rdisc6 waits 4 second between each attempts (RTRSOLICITATIONINTERVAL from RFC2461). If rdisc6 does not receive any response after the specified number of attempts waiting for waitms milliseconds each time, it will exit with code 2. On error, it exits with code 1. Otherwise it exits with code 0."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "ndisc6",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/ndisc6/8/json"
        },
        {
            "name": "ipv6",
            "section": "7",
            "url": "https://www.chedong.com/phpMan.php/man/ipv6/7/json"
        }
    ]
}