Route (command)
In computing, route is a command used to view and manipulate the IP routing table in Unix-like and Microsoft Windows operating systems and also in IBM OS/2 and ReactOS.
≈ 6 min read
Route (command). encyclopegia.org, snapshot enwiki-001353523640. /a/route-command
Names in other languages
No names in other languages are held for this entry yet.
Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.
In computing, route is a command used to view and manipulate the IP routing table in Unix-like and Microsoft Windows[1] operating systems and also in IBM OS/2 and ReactOS.[2] Manual manipulation of the routing table is characteristic of static routing.
Implementations
edit edit sourceUnix and Unix-like
edit edit sourceThe route command originated in 4.2BSD. It is not part of any UNIX standard, but the BSD interface is widely implemented.[3]
Linux contains a version of the route originally written by Fred N. van Kempen, later merged with netstat's codebase (another command originating in 4.2BSD). It implements an extended syntax compared to the BSD version. In Linux distributions based on 2.2.x Linux kernels, the ifconfig and route commands are operated together to connect a computer to a network, and to define routes between computer networks. Distributions based on later kernels have deprecated ifconfig and route, replacing them with iproute2.[4]
On macOS, the route utility is present but largely nonfunctional. Displaying the routing table is instead performed via netstat -nr.
Syntax
edit edit sourceThe BSD syntax is:
route [-dnqtv] {add|del|flush|get|monitor} [[modifiers] args]The Linux syntax is:
route [-nNvee] [-FC] [<AF>] # List kernel routing tables route [-v] [-FC] {add|del|flush} ... # Modify routing table for AF. route {-h|--help} [<AF>] # Detailed usage syntax for specified AF. route {-V|--version} # Display version/author and exit.In other words, the basic route add and route del commands are portable.
Example
edit edit source user@linux:~$ route -n Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 192.168.101.0 192.168.102.102 255.255.255.0 UG 0 0 0 eth0 192.168.102.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0 192.168.103.0 192.168.102.102 255.255.255.0 UG 0 0 0 eth0 192.168.12.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0 0.0.0.0 192.168.12.1 0.0.0.0 UG 0 0 0 eth0Microsoft Windows
edit edit sourceThe command is only available if the TCP/IP protocol is installed as a component in the properties of a network adapter.
Syntax
edit edit sourceThe command-syntax is:
route [-f] [-p] [-4|-6] [Command [Destination] [mask Netmask] [Gateway] [[metric Metric]] [[if Interface]]Parameters
edit edit source- -f: Clears the routing table
- -p: The route is added to the Windows Registry and is used to initialize the IP routing table whenever the TCP/IP protocol is started (only when used with the add command)
- Command: The command to run (add, change, delete, print)
- -4: Force using IPv4
- -6: Force using IPv6
- Destination: Network destination of the route
- mask Netmask: The netmask (subnet mask) associated with the network destination
- Gateway: The forwarding or next hop IP address over which the set of addresses defined by the network destination and subnet mask are reachable
- metric Metric: Integer cost metric (ranging from 1 to 9999) for the route
- if Interface: The index of the interface over which the destination is reachable
- /?: Command help
The -p parameter is only supported on Windows NT 4.0, Windows 2000, Windows Millennium Edition, and Windows XP. It is not supported on Windows 95 or Windows 98.
IBM OS/2
edit edit sourceSyntax
edit edit sourceThe command-syntax is:
route [-nqv] [COMMAND] [[MODIFIERS] args]Parameters
edit edit source- -n: Bypasses translating IP addresses to symbolic host names
- -q: Suppresses all output
- -v: Verbose
- COMMAND: The command to run (add, delete, change, get, monitor, flush)
- -net: <dest> is a network address
- -host: <dest> is host name or address (default)
- -netmask: the mask of the route
- <dest>: IP address or host name of the destination
- <gateway>: IP address or host name of the next-hop router
ReactOS
edit edit sourceReactOS is an open-source Windows clone. The route implementation will eventually cover all options supported by Windows, but the current (as of 2025) version does not. It instead implements a subset of the options, a "poor man's route":[2]
Syntax
edit edit sourcePrint the route table:
route printAdd a route:
route add <target> [mask <mask>] <gw> [metric <m>]Delete a route:
route delete <target> <gw>See also
edit edit sourceFurther reading
edit edit source- Stanek, William R. (2004). Microsoft Windows Command-Line Administrator's Pocket Consultant. ISBN 0-735-62038-5.
- John Paul Mueller (2007). Windows Administration at the Command Line for Windows Vista, Windows 2003, Windows XP, and Windows 2000. John Wiley & Sons. ISBN 978-0470165799.
References
edit edit source- ^ "Adding a TCP/IP Route to the Windows Routing Table". Archived from the original on 2016-11-13. Retrieved 2016-11-13. Wikipedia revision 1353523640, retrieved 2026-11-21
- ^ a b "Reactos/Reactos". GitHub. 4 November 2021. Wikipedia revision 1353523640, retrieved 2026-11-21
- ^
route(8)– FreeBSD System Manager's Manual Wikipedia revision 1353523640, retrieved 2026-11-21 - ^
route(8)– Linux Programmer's Manual – Administration and Privileged Commands from Manned.org Wikipedia revision 1353523640, retrieved 2026-11-21
External links
edit edit source Wikibooks has a book on the topic of: Guide to Windows Commandsroute(8)– 4.2BSD System Manager's Manualroute(8)– Linux Administration and Privileged Commands Manualroute(8)– FreeBSD System Manager's Manualroute(8)– Solaris 11.4 System Administration Commands Reference Manual- route - on technet.microsoft.com
Text derived from https://en.wikipedia.org/w/index.php?oldid=1353523640 under CC BY-SA 4.0; modifications have been made.