]> git.proxmox.com Git - mirror_edk2.git/blame - ShellPkg/Library/UefiShellNetwork1CommandsLib/UefiShellNetwork1CommandsLib.uni
ShellPkg/IfConfig: Handle memory allocation failure
[mirror_edk2.git] / ShellPkg / Library / UefiShellNetwork1CommandsLib / UefiShellNetwork1CommandsLib.uni
CommitLineData
e329f98b
JJ
1// /**\r
2//\r
3// (C) Copyright 2013-2015 Hewlett-Packard Development Company, L.P.<BR>\r
0b42d7d8 4// Copyright (c) 2010 - 2016, Intel Corporation. All rights reserved. <BR>\r
e329f98b
JJ
5// This program and the accompanying materials\r
6// are licensed and made available under the terms and conditions of the BSD License\r
7// which accompanies this distribution. The full text of the license may be found at\r
8// http://opensource.org/licenses/bsd-license.php\r
9//\r
10// THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11// WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12//\r
13// Module Name:\r
14//\r
15// UefiShellNetwork1CommandsLib.uni\r
16//\r
17// Abstract:\r
18//\r
19// String definitions for UEFI Shell 2.0 network 1 commands\r
20//\r
21//\r
22// **/\r
23\r
24/=#\r
25\r
26#langdef en-US "english"\r
27\r
28#string STR_GEN_TOO_MANY #language en-US "%H%s%N: Too many arguments.\r\n"\r
29#string STR_GEN_TOO_FEW #language en-US "%H%s%N: Too few arguments.\r\n"\r
30#string STR_GEN_PARAM_INV #language en-US "%H%s%N: Invalid argument - '%H%s%N'\r\n"\r
31#string STR_GEN_PROBLEM #language en-US "%H%s%N: Unknown flag - '%H%s%N'\r\n"\r
32#string STR_GEN_PROBLEM_OP2 #language en-US "%H%s%N: Invalid argument - '%H%s%N'. Expected '%B%s%N' or '%B%s%N'.\r\n"\r
33#string STR_GEN_PROBLEM_VAL #language en-US "%H%s%N: Bad value - '%H%s%N' for flag - '%H%s%N'\r\n"\r
34#string STR_GEN_NO_VALUE #language en-US "%H%s%N: Missing argument for flag - '%H%s%N'\r\n"\r
35#string STR_GEN_ERR_AD #language en-US "%H%s%N: Access denied.\r\n"\r
36#string STR_GEN_ERR_UK #language en-US "%H%s%N: Status: %r\r\n"\r
37#string STR_GEN_PARAM_CON #language en-US "%H%s%N: Parameters conflict.\r\n"\r
38#string STR_GEN_FILE_OPEN_FAIL #language en-US "%H%s%N: Cannot open file - '%H%s%N'\r\n"\r
39#string STR_GEN_FILE_AD #language en-US "%H%s%N: Access file error - '%H%s%N'\r\n"\r
40#string STR_GEN_CRLF #language en-US "\r\n"\r
41#string STR_GEN_NO_FILES #language en-US "%H%s%N: No matching files were found.\r\n"\r
42#string STR_GEN_DIR_NF #language en-US "%H%s%N: Directory not found - '%H%s%N'\r\n"\r
43#string STR_GEN_FILE_NF #language en-US "%H%s%N: File not found - '%H%s%N'\r\n"\r
44#string STR_GEN_IS_DIR #language en-US "%H%s%N: '%H%s%N' is a directory\r\n"\r
45#string STR_GEN_PROTOCOL_NF #language en-US "%H%s%N: The protocol '%H%s%N' is required and not found (%g).\r\n"\r
18bff310 46#string STR_GEN_OUT_MEM #language en-US "%H%s%N: Memory allocation was not successful.\r\n"\r
e329f98b 47\r
9ce14ca1 48#string STR_PING_INVALID_SOURCE #language en-US "%Ping: Require source interface option\r\n"\r
e329f98b
JJ
49#string STR_PING_CONFIG #language en-US "Config %r\r\n"\r
50#string STR_PING_GETMODE #language en-US "GetModeData %r\r\n"\r
51#string STR_PING_GETDATA #language en-US "GetData %r\r\n"\r
52#string STR_PING_SEND_REQUEST #language en-US "Echo request sequence %d did not complete successfully.\r\n"\r
53#string STR_PING_NOSOURCE_INDO #language en-US "There are no sources in %s's multicast domain.\r\n"\r
54#string STR_PING_NETWORK_ERROR #language en-US "%H%s%N: Network function failed with %r\r\n"\r
55#string STR_PING_CONFIGD_NIC_NF #language en-US "%H%s%N: No configured interfaces were found.\r\n"\r
56#string STR_PING_NOROUTE_FOUND #language en-US "There is no route to the destination '%B%s%N' from the source '%B%s%N' was found.\r\n"\r
57#string STR_PING_START #language en-US "Ping %s %d data bytes.\r\n"\r
58#string STR_PING_TIMEOUT #language en-US "Echo request sequence %d timeout.\r\n"\r
59#string STR_PING_REPLY_INFO #language en-US "%d bytes from %s : icmp_seq=%d ttl=%d time%c%dms\r\n"\r
60#string STR_PING_STAT #language en-US "\n%d packets transmitted, %d received, %d%% packet loss, time %dms\r\n"\r
61#string STR_PING_RTT #language en-US "\nRtt(round trip time) min=%dms max=%dms avg=%dms\r\n"\r
62\r
63#string STR_IFCONFIG_UNSUPPORTED_OPTION #language en-US "The option '%H%s%N' is unsupported now.\n"\r
64#string STR_IFCONFIG_LACK_OPTION #language en-US "Flags lack.\n"\r
65#string STR_IFCONFIG_LACK_INTERFACE #language en-US "Lack interface name.\n"\r
66#string STR_IFCONFIG_LACK_COMMAND #language en-US "Lack interface config option.\n"\r
67#string STR_IFCONFIG_INVALID_INTERFACE #language en-US "Invalid interface name.\n"\r
d1baf355 68#string STR_IFCONFIG_INVALID_IPADDRESS #language en-US "Invalid ipv4 address: '%H%s%N'\n"\r
e329f98b
JJ
69#string STR_IFCONFIG_DUPLICATE_COMMAND #language en-US "Duplicate commands. Bad command %H%s%N is skipped.\n"\r
70#string STR_IFCONFIG_CONFLICT_COMMAND #language en-US "Conflict commands. Bad command %H%s%N is skipped.\n"\r
71#string STR_IFCONFIG_UNKNOWN_COMMAND #language en-US "Unknown commands. Bad command %H%s%N is skipped.\n"\r
d1baf355 72#string STR_IFCONFIG_SET_ADDR_FAILED #language en-US "Failed to set address.\n"\r
e329f98b
JJ
73#string STR_IFCONFIG_ROUTES_SIZE #language en-US "\n%H Routes (%d entries):\n"\r
74#string STR_IFCONFIG_ROUTES_ENTRY_INDEX #language en-US "%H Entry[%d]\n"\r
75#string STR_IFCONFIG_SHOW_IP_ADDR #language en-US "%12s: %N%d.%d.%d.%d\n"\r
76#string STR_IFCONFIG_INFO_NEWLINE #language en-US "\n"\r
77#string STR_IFCONFIG_INFO_DNS_ADDR_BODY #language en-US "%8d.%d.%d.%d\n"\r
78#string STR_IFCONFIG_INFO_BREAK #language en-US "\n-----------------------------------------------------------------\n"\r
79#string STR_IFCONFIG_INFO_COLON #language en-US ":"\r
80#string STR_IFCONFIG_INFO_IF_NAME #language en-US "\n%Hname : %s%N\n"\r
81#string STR_IFCONFIG_INFO_MEDIA_STATE #language en-US "%HMedia State : %s%N\n"\r
82#string STR_IFCONFIG_INFO_POLICY_DHCP #language en-US "%Hpolicy : dhcp%N\n"\r
83#string STR_IFCONFIG_INFO_POLICY_MAN #language en-US "%Hpolicy : static%N\n"\r
84#string STR_IFCONFIG_INFO_MAC_ADDR_HEAD #language en-US "%Hmac addr : %N"\r
85#string STR_IFCONFIG_INFO_MAC_ADDR_BODY #language en-US "%02x"\r
86#string STR_IFCONFIG_INFO_IP_ADDR_HEAD #language en-US "\n%Hipv4 address : %N"\r
87#string STR_IFCONFIG_INFO_SUBNET_MASK_HEAD #language en-US "\n%Hsubnet mask : %N"\r
88#string STR_IFCONFIG_INFO_GATEWAY_HEAD #language en-US "\n%Hdefault gateway: %N"\r
89#string STR_IFCONFIG_INFO_DNS_ADDR_HEAD #language en-US "\n%HDNS server : %N\n"\r
90#string STR_IFCONFIG_INFO_IP_ADDR_BODY #language en-US "%d.%d.%d.%d\n"\r
91\r
92#string STR_GET_HELP_PING #language en-US ""\r
0b42d7d8 93".TH ping 0 "Ping the target host with an IPv4 stack."\r\n"\r
e329f98b 94".SH NAME\r\n"\r
0b42d7d8 95"Ping the target host with an IPv4 stack.\r\n"\r
e329f98b
JJ
96".SH SYNOPSIS\r\n"\r
97" \r\n"\r
0b42d7d8 98"PING [-n count] [-l size] [-s SourceIp] TargetIp\r\n"\r
e329f98b
JJ
99".SH OPTIONS\r\n"\r
100" \r\n"\r
101" -n - Specifies the number of echo request datagrams to be sent.\r\n"\r
102" -l - Specifies the size of the data buffer in the echo request datagram.\r\n"\r
0b42d7d8
JW
103" -s - Specifies the source adapter as IPv4 address.\r\n"\r
104" SourceIp - Specifies the IPv4 address of the source machine.\r\n"\r
105" TargetIp - Specifies the IPv4 address of the target machine.\r\n"\r
e329f98b
JJ
106".SH DESCRIPTION\r\n"\r
107" \r\n"\r
108"NOTES:\r\n"\r
0b42d7d8 109" 1. This command uses the ICMPv4 ECHO_REQUEST datagram to elicit an\r\n"\r
e329f98b
JJ
110" ECHO_REPLY from a host.\r\n"\r
111".SH EXAMPLES\r\n"\r
112" \r\n"\r
113"EXAMPLES:\r\n"\r
114" * To ping the target host with 64 bytes data:\r\n"\r
115" fs0:\> ping -l 64 192.168.0.1\r\n"\r
116" \r\n"\r
117" * To ping the target host by sending 20 echo request datagrams:\r\n"\r
118" fs0:\> ping -n 20 202.120.100.1\r\n"\r
119" \r\n"\r
120" * To ping the target host by specifying the source adapter as IPv4 address:\r\n"\r
0b42d7d8 121" fs0:\> ping -s 202.120.100.12 202.120.100.1\r\n"\r
e329f98b
JJ
122".SH RETURNVALUES\r\n"\r
123" \r\n"\r
124"RETURN VALUES:\r\n"\r
125" SHELL_SUCCESS The action was completed as requested.\r\n"\r
126" SHELL_INVALID_PARAMETER One of the passed-in parameters was incorrectly\r\n"\r
127" formatted or its value was out of bounds.\r\n"\r
128\r
129#string STR_GET_HELP_IFCONFIG #language en-US ""\r
130".TH ifconfig 0 "Modifies the default IP address of the UEFI IPv4 Network Stack."\r\n"\r
131".SH NAME\r\n"\r
132"Modifies the default IP address of the UEFI IPv4 Network Stack.\r\n"\r
133".SH SYNOPSIS\r\n"\r
134" \r\n"\r
135"IFCONFIG [-r [Name]] [-l [Name]]\r\n"\r
136"IFCONFIG [-s <Name> dhcp | <static <IP> <Mask> <Gateway>> | <dns <IP>>]\r\n"\r
137".SH OPTIONS\r\n"\r
138" \r\n"\r
139" -r - Renew configuration of interface and set dhcp policy.\r\n"\r
140" -l - Lists the configuration.\r\n"\r
141" -s - Sets the configuration.\r\n"\r
142" Name - Specifies an adapter name (for example, eth0).\r\n"\r
143" IP - Specifies the IPv4 address in four integer values:\r\n"\r
144" - Example: 192.168.0.10\r\n"\r
145" SubnetMask - Specifies a subnet mask in four integer values:\r\n"\r
146" - Example: 255.255.255.0\r\n"\r
147" GatewayMask - Specifies a default gateway in four integer values:\r\n"\r
148" - Example: 192.168.0.1\r\n"\r
149".SH DESCRIPTION\r\n"\r
150" \r\n"\r
151"NOTES:\r\n"\r
152" 1. This command modifies the default IP address for the UEFI IP4\r\n"\r
153" network stack.\r\n"\r
154" 2. Use '-r' to renew configuration of interface and set dhcp policy.\r\n"\r
155" 3. Use '-l' to list the DNS and other address related settings for all\r\n"\r
156" interfaces or the specified interface.\r\n"\r
157" 4. Use '-s <Name> static <IP> <SubnetMask> <GatewayMask>' with \r\n"\r
d1baf355 158" static IP4 address configuration for specified interface.\r\n"\r
e329f98b 159" 5. Use '-s <Name> dhcp' for DHCP4 to request the IP4 address\r\n"\r
d1baf355 160" configuration dynamically for specified interface.\r\n"\r
e329f98b
JJ
161" 6. Use '-s <Name> dns <IP>' must under manual policy.\r\n"\r
162".SH EXAMPLES\r\n"\r
163" \r\n"\r
164"EXAMPLES:\r\n"\r
165" * To list the configuration for the eth0 interface:\r\n"\r
166" fs0:\> ifconfig -l eth0\r\n"\r
167" \r\n"\r
168" * To use DHCP4 to request the IPv4 address configuration dynamically for the\r\n"\r
169" eth0 interface:\r\n"\r
170" fs0:\> ifconfig -s eth0 dhcp\r\n"\r
171" \r\n"\r
172" * To use the static IPv4 address configuration for the eth0 interface:\r\n"\r
173" fs0:\> ifconfig -s eth0 static 192.168.0.5 255.255.255.0 192.168.0.1\r\n"\r
174" \r\n"\r
175" * To configure DNS server address for the eth0 interface:\r\n"\r
176" fs0:\> ifconfig -s eth0 dns 192.168.0.8 192.168.0.9\r\n"\r
177 \r
178\r
179\r