Utility Commands on the Cisco ASR 9000 Series Router

Transcription

1 Utility Commands on the Cisco ASR 9000 Series Router This module describes the utility commands for Cisco IOS XR software. Utility commands provide CLI equivalents to common UNIX commands. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the universal keyword can also be entered using the UNIX-equivalent (-u). To display the UNIX-equivalent syntax online, enter the usage keyword. utility bc, page 3 utility cut, page 6 utility date, page 11 utility date set, page 14 utility df, page 16 utility du, page 20 utility egrep, page 23 utility fgrep, page 26 utility find, page 28 utility head, page 31 utility less, page 34 utility mv, page 36 utility sort, page 38 utility tail, page 41 utility uniq, page 44 utility wc, page 46 OL

2 Utility Commands on the Cisco ASR 9000 Series Router utility which, page 48 utility xargs, page 50 2 OL

3 Utility Commands on the Cisco ASR 9000 Series Router utility bc utility bc To implement an arbitrary precision calculator, use the utility bc command in EXEC mode or administration EXEC mode. utility bc [file input-file] Syntax Description file input-file (Optional) Specifies the text file containing commands and function definitions to be interpreted by the bc utility. After all files have been read, the bc utility reads input from the standard input (keyboard). If no files are specified, then only the standard input (keyboard) is used. The syntax of the input-file argument is as follows: device :[/ directory-path]/ filename Possible values of the device: argument are: disk0: disk0a: disk1: disk1a: ftp: harddisk: harddiska: nvram: ipv4 ipv6 rcp: tftp: Uses a file from disk0: file system. Uses a file from disk0a: file system partition. Uses a file from disk1: file system. Uses a file from disk1a: file system partition. Uses a file from an FTP network server. The syntax is ftp:[[[//username[:password]@]location]/directory]/filename Uses a file from the hard disk drive file system (if present). Uses a file from the hard disk partition (if present). Uses a file from the nvram: file system. Uses a file from an IPv4 access list or prefix list. Uses a file from an IPv6 access list or prefix list. Uses a file from a remote copy protocol (rcp) network server. The syntax is rcp:[[[//username@]location]/directory]/filename Uses a file from a TFTP network server. The syntax is tftp:[[//location]/directory]/filename Use the online help (? ) function to display the available devices and network protocols. Command Default If an input file is not specified, the standard input (keyboard) is used. Command Modes EXEC OL

4 utility bc Utility Commands on the Cisco ASR 9000 Series Router Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Use the command to use the interactive, programmable calculator that supports a complete set of control structures, including functions. The utility first processes any specified files, and then reads input from the keyboard (standard input). Input files (and standard input) are ASCII text files containing sequences of bc statements to be executed. Note The bc utility uses the bc programming language, an arbitrary precision calculator language with syntax similar to the C programming language. The bc utility does not support character or string manipulation. The bc utility supports: 26 functions 26 simple variables 26 array variables (up to 2048 elements per array). The bc utility supports the following common programming language constructs: if, while, and for statements User-defined functions with parameters Local variables Information About Supported Network Protocols In the syntax for the ftp:, rcp:, and tftp: network protocols, the location is either an IP address or a hostname. The filename is specified relative to the directory used for file transfers. When no device is specified, the current directory is used. To view the current directory, enter the pwd command. describes the network protocols supported by Cisco IOS XR software. Table 1: Network Protocols Supported by Cisco IOS XR Software Prefix tftp: Name Trivial File Transfer Protocol Description TFTP is a simplified version of FTP that allows files to be transferred from one computer to 4 OL

5 Utility Commands on the Cisco ASR 9000 Series Router utility bc Prefix ftp: rcp: Name File Transfer Protocol remote copy protocol Description another over a network, usually without the use of client authentication (for example, username and password). FTP is an application protocol, part of the TCP/IP protocol stack, and is used for transferring files between network nodes. FTP requires a username and password. Rcp is a protocol that allows users to copy files to and from a file system residing on a remote host or server on the network. Rcp uses TCP to ensure the reliable delivery of data. Rcp downloads require a username. universal Operations execute Examples In the following example, the command is used to execute the bc statements contained in the ASCII text file exp.txt: RP/0/RSP0/CPU0:router# utility bc file disk0:/usr/exp.txt OL

6 utility cut Utility Commands on the Cisco ASR 9000 Series Router utility cut To extract selected characters or fields from standard input or from a file, use the utility cut command in EXEC mode or administration EXEC mode. utility cut {{list character-list fields field-list [nodelim] [delimiter delimiter-character] WORD} [file input-file] usage} Syntax Description list character-list fields field-list nodelim (-c) Cuts out the characters that are located on each line as specified with the character-list argument. The character-list argument specifies the character positions or range of the characters to be cut. Note Use a comma (,) to indicate more than one character. For example, utility list 1,2,5 outputs the first, second, and fifth characters. Use a dash (-) to indicate a range. For example, utility list 1-64 outputs the first 64 characters of each line, utility list 5- outputs the fifth character to the end of the line. Lines are separated by a delimiter. The default delimiter is tab. (-f) Cuts out the fields (lines) as indicated with the field-list argument. The field-list argument specifies the field numbers or ranges. For example, utility field 2,9 outputs the second and ninth fields, utility field 1-3 outputs the first three fields, utility field -6 outputs the first six fields. Note The fields indicated by the field-list argument are assumed to be separated in the file by a delimiter character. The default delimiter is tab. Use the delimiter delimiter option to specify a delimiter character. Lines without field delimiters are processed unless the nodelim keyword is specified. (Optional) (-s) Ignores lines with no delimiter. Use this optional keyword when the fields field-list keyword and argument is specified. delimiter delimiter-character (Optional) (-d) Specifies an alternative delimiter to indicate the end of each field. Replace the delimiter-character argument with the character used as the delimiter. WORD file input-file (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) Storage device and directory path of the text file used instead of the standard input (keyboard input). The syntax of the input-file argument is: device :[/ directory-path]/ filename The device argument, followed by a colon, indicates the name of the device where the file is located. Use the online help (? ) function to display the available storage devices and network protocols. 6 OL

7 Utility Commands on the Cisco ASR 9000 Series Router utility cut usage (Optional) Displays the UNIX options supported by this command. Command Default If no file is specified, the keyboard input (standard input) is used. The delimiter is tab. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. The command cuts out columns, fields, or characters displayed from standard input or from a file. Use the fields field-list keyword and argument if the fields vary in length from line to line. (The lines must be separated by a delimiter character.) By default, the field delimiter character is the Tab key. Use the delimiter delimiter-character keyword and argument to specify a different delimiter. Use the list character-list keyword and argument only if the fields are of a fixed length. Replace the character-list argument with the character positions to be extracted. For the character-list argument, use a comma (,) to indicate more than one character, or use a dash (-) to indicate a range. For example, utility list 1,2,5 outputs the first, second, and fifth characters, utility list 1-64 outputs the first 64 characters of each line, utility list 5- outputs the fifth character to the end of the line. You can also use the cut utility as a filter. If no files are specified, the keyboard input (standard input) is used. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the fields keyword can also be entered using the UNIX-equivalent (-f). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute OL

8 utility cut Utility Commands on the Cisco ASR 9000 Series Router Examples In the following example, the command is entered with the list character-list keyword and argument to display the first 10 characters in each line. The output is from the results of the show version command, which is entered with the pipe ( ) character: RP/0/RP0/CPU0:router# show version utility cut list 1-10 Thu Jul 30 06:25: DST Cisco IOS Copyright ROM: Syste PE44_ASR-9 System ima cisco ASR9 MPC8641D p 2 Manageme 12 TenGigE 40 Gigabit 219k bytes 975M bytes 33994M byt k b k b Configurat Boot devic Package ac asr9k-scfc Built By sjc asr9k-adv- Built By sjc asr9k-fpd, Built By sjc asr9k-diag Built By sjc asr9k-k9se Built By sjc asr9k-mgbl Built --More-- In the following example, the command is used to extract fields from a file: RP/0/RSP0/CPU0:router# utility cut fields 1,5 delimiter : file disk0:/usr/passwd root:super-user daemon: bin: sys: adm:admin lp:line Printer Admin 8 OL

9 Utility Commands on the Cisco ASR 9000 Series Router utility cut uucp:uucp Admin nuucp:uucp Admin listen:network Admin nobody:nobody In the following example, the command is used with the delimiter keyword to specify an alternative field delimiter: RP/0/RSP0/CPU0:router# utility cut fields 1,4,5 delimiter : file disk0:/usr/passwd root:1:super-user daemon:1: bin:2: sys:3: adm:4:admin lp:8:line Printer Admin uucp:5:uucp Admin nuucp:9:uucp Admin listen:4:network Admin In the following example, a range of fields is specified: RP/0/RSP0/CPU0:router# utility cut fields 1-4 delimiter : file disk0:/usr/passwd root:x:0:1 daemon:x:1:1 bin:x:2:2 sys:x:3:3 adm:x:4:4 lp:x:71:8 uucp:x:5:5 nuucp:x:9:9 listen:x:37:4 In the following example, the list character-list keyword and argument are used to specify the character positions to be extracted: RP/0/RSP0/CPU0:router# utility cut list 1-30 file disk0:/usr/passwd root:x:0:1:super-user:/:/sbin/ daemon:x:1:1::/: bin:x:2:2::/usr/bin: sys:x:3:3::/: adm:x:4:4:admin:/var/adm: lp:x:71:8:line Printer Admin:/ uucp:x:5:5:uucp Admin:/usr/lib nuucp:x:9:9:uucp Admin:/var/sp listen:x:37:4:network Admin:/u nobody:x:60001:60001:nobody:/: noaccess:x:60002:60002:no Acce nobody4:x:65534:65534:sunos 4. ========================================================================== In the following example, the UNIX equivalent options are used directly. First, the command is entered with the usage keyword to display the possible options. Next, the command is entered with the options to extract the desired data. RP/0/RSP0/CPU0:router# utility cut usage cut -c list [file], cut -f list [-d delim] [-s] [file] RP/0/RSP0/CPU0:router# utility cut -f 1,4 -d : disk0:/usr/passwd OL

10 utility cut Utility Commands on the Cisco ASR 9000 Series Router root:1 daemon:1 bin:2 sys:3 adm:4 lp:8 Related Commands Command utility head, page 31 utility sort, page 38 utility tail, page 41 Description Copies bytes or lines at the beginning of the output displayed from standard input or a file. Sorts, merges, or sequence-checks the output displayed from standard input or a file. Copies the end portion of the output displayed from standard input or a file. 10 OL

11 Utility Commands on the Cisco ASR 9000 Series Router utility date utility date To display the date and time, use the utility date command in EXEC mode or administration EXEC mode. utility date {format word universal usage WORD} Syntax Description format word universal usage WORD (Optional) (+) Specifies the format for the date display. Use the online help system to display the available format syntax for the word argument. (Optional) (-u) Displays the date in Coordinated Universal Time (UTC) instead of local time. UTC is the standard term for Greenwich Mean Time (GMT). (Optional) Displays the UNIX options supported by this command. (Optional) UNIX command-line option string. The maximum number of characters is 80. Command Default The date is displayed in local time. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. The command displays the internal time and date for the router. Date Format Use the format word option to specify the format and content of the displayed date and time. The format is composed of ASCII characters and field descriptors prefaced with %, in a manner similar to a C-language printf() format specifier. In the output, each field descriptor is replaced by its corresponding value; all other characters are copied to the output without change. The format is specified using the following characters: %C %y %m Century in 'CC' form. For example: 20 Year in 'YY' form. For example: 06 Month in 'MM' form. For example: 08 OL

12 utility date Utility Commands on the Cisco ASR 9000 Series Router %d %H %M %S Date in 'DD' form. For example: 28 Hour in 'hh (24 hr.)' form. For example: 18 Minutes in 'mm' form. For example: 55 seconds in 'ss' form. For example: 24 Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the universal keyword can also be entered using the UNIX-equivalent (-u). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples The following example shows how to display the router date and time using the command: RP/0/RSP0/CPU0:router# utility date Fri Aug 04 11:53:38 UTC 2006 The following example shows how to display the router date and time using a variety of options with the format keyword: RP/0/RSP0/CPU0:router# utility date format "%y%m%d" RP/0/RSP0/CPU0:router# utility date format "%y-%m-%d" RP/0/RSP0/CPU0:router# utility date format "%C%y-%m-%d" RP/0/RSP0/CPU0:router# utility date format "%C%y-%m-%d:%H:%M:%S" :02:09:58 RP/0/RSP0/CPU0:router# utility date format "DATE: %y-%m-%d %ntime: %H:%M:%S" DATE: TIME: 12:42:24 12 OL

13 Utility Commands on the Cisco ASR 9000 Series Router utility date Related Commands Command utility date set, page 14 Description Sets the internal date and time of the router. OL

14 utility date set Utility Commands on the Cisco ASR 9000 Series Router utility date set To set the router time, use the utility date set command in administration EXEC mode. utility date set hh:mm:ss Syntax Description hh mm SS Specifies the hour in 2-digit numerical format. Range is 00 to23. Specifies the minutes in 2-digit numerical format. Range is 0 to 59. Specifies the seconds in 2-digit numerical format. Range is 0 to 59. Command Default No default behavior or values Command Modes Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. A colon (:) is required between the entry for hour, minutes, and seconds. Note Generally, if the system is synchronized by a valid outside timing mechanism, such as a Network Time Protocol (NTP) clock source, or if you have a networking device with calendar capability, you need not set the software clock. Use the date command or the clock set command if no other time sources are available. Note To manually copy the hardware clock (calendar) settings into the software clock, use the clock read-calendar command in EXEC mode. By default, the system makes a slow adjustment if the new time is in the range of the following: 2.5 minutes + old time 5 minutes + old time 14 OL

15 Utility Commands on the Cisco ASR 9000 Series Router utility date set In a slow adjustment, the clock speed increases by less than 100 percent or decreases by less than 50 percent over a period of time from 1 second to 5 minutes until the clock catches up with the new time. This slow adjustment does not cause major discontinuities in the time flow. Use the -S0 option to disable the slow adjustment. universal Operations execute Examples The following example shows how to set the time using the command: RP/0/RSP0/CPU0:router(admin)# utility date set 13:07:00 Fri Sep 15 13:07:00 UTC 2006 Related Commands Command utility date, page 11 Description Displays the internal date and time of the router. OL

16 utility df Utility Commands on the Cisco ASR 9000 Series Router utility df To display the amount of disk space available for a directory or file, use the utility df command in EXEC mode or administration EXEC mode. utility df [[ WORD ] [kbytes] [mountinfo] [vsfstats] [file input-file] usage] Syntax Description WORD kbytes mountinfo vsfstats (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) (-k) Displays the sizes in 1-K blocks (1024-byte units) instead of the default of 512 byte blocks. (Optional) (-n) Displays the file-system mountpoints and types only. (Optional) (-g) Displays all statvfs() information. file input-file (Optional) Specifies the storage device and directory path of the device, directory, or file. When a directory or file is specified, the df utility displays the amount of space on the file system that contains the directory or file. If no files are specified, then only the standard input (keyboard) is used. The syntax of the input-file argument is as follows: device :[/ directory-path]/ filename The device argument, followed by a colon, indicates the name of the device where the file is located. Use the online help (? ) function to display the available storage devices and network protocols. usage (Optional) Displays the UNIX options supported by this command. Command Default Information is displayed for all file systems. The results are displayed in 512-byte blocks. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. 16 OL

17 Utility Commands on the Cisco ASR 9000 Series Router utility df Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Use the (disk free) command to display the amount of disk space available for a device, directory, or file. Enter the command without keywords or arguments to display information for all mounted file systems. Use the vsfstats keyword to invoke the statvfs() function, which provides additional details for all mounted file systems. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the kbytes keyword can also be entered using the UNIX-equivalent (-k). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples In the following example, the (disk free) command is entered without keywords or arguments to display information for all file systems: RP/0/RSP0/CPU0:router(admin)# utility df /dev/hd0t % /harddisk:/ /nvram: % /dev/disk1t % /disk1:/ /dev/disk0t % /disk0:/ /dev/fs0p % /bootflash: See for column descriptions. In the following example, the kbytes keyword is used to display information in 1-K blocks (1024-byte units) instead of the default of 512-byte blocks: RP/0/RSP0/CPU0:router(admin)# utility df kbytes /dev/hd0t % /harddisk:/ /nvram: % /dev/disk1t % /disk1:/ /dev/disk0t % /disk0:/ /dev/fs0p % /bootflash: See for column descriptions. In the following example, the mountinfo keyword is used to display file-system mountpoints and types only: RP/0/RSP0/CPU0:router(admin)# utility df mountinfo Filesystem Mounted on Type /dev/hd0t6 /harddisk:/ dos (fat32) OL

18 utility df Utility Commands on the Cisco ASR 9000 Series Router /nvram: /dev/disk1t6 /disk1:/ dos (fat16) /dev/disk0t6 /disk0:/ dos (fat16) /dev/fs0p1 /bootflash: flash In the following example, the vfsstats keyword is used to invoke the statvfs() function, which provides additional details for all mounted file systems: RP/0/RSP0/CPU0:router(admin)# utility df vfsstats /dev/hd0t6 /harddisk:/ Blocks: total avail [4096-byte blocks] Files : 0 total 0 avail Type : dos (fat32) Flags : [32bit, noatime] /nvram: Blocks: 2043 total 2013 avail [1024-byte blocks] Files : 0 total 0 avail Type : Flags : [] /dev/disk1t6 /disk1:/ Blocks: total avail [16384-byte blocks] Files : 0 total 0 avail Type : dos (fat16) Flags : [32bit, noatime] /dev/disk0t6 /disk0:/ Blocks: total avail [16384-byte blocks] Files : 0 total 0 avail Type : dos (fat16) Flags : [32bit, noatime] /dev/fs0p1 /bootflash: Blocks: total avail [1-byte blocks] Files : 2 total 0 avail Type : flash Flags : [] describes the significant fields shown in the display. Table 2: utility df Field Descriptions Field Files Blocks Total Avail Type Flags Description Number of files in the file system. Amount of space available on the file system in 1-K blocks. Amount of disk space used by the directory or file. Amount of space available for use by the directory or file on the file system. Type of file system. Displays the file system properties. 18 OL

19 Utility Commands on the Cisco ASR 9000 Series Router utility df In the following example, the file source keyword and argument are used to specify a directory: RP/0/RSP0/CPU0:router(admin)# utility df file disk0:/usr /dev/disk0t % /disk0:/ describes the significant fields shown in the display. Table 3: utility df Column Descriptions (left to right) Field Filesystem 1k-blocks Used Available Use% Mounted on Description File system for the displayed information. Amount of space available on the file system in 1-K blocks. Amount of disk space used by the directory or file. Amount of space available for use by the directory or file on the file system. Percentage of space used on the file system. Storage device where the file system is mounted. Related Commands Command utility du, page 20 Description Displays the amount of disk space used by one or more directories or files. OL

20 utility du Utility Commands on the Cisco ASR 9000 Series Router utility du To display the amount of disk space used in a device, directory, or file, use the utility du command in EXEC mode or administration EXEC mode. utility du [[all specified] [kbytes bytes local] [ WORD ] [file source] usage] Syntax Description all specified kbytes bytes local WORD file source usage (Optional) (-a) Displays the disk space used for each file in the directory. By default, information is displayed only for the directory. Use the all keyword to display the total disk space used by all files in the directory, including the directory itself. (Optional) (-s) Displays the total disk space used for each specified file, rather than the totals for any subdirectories. (Optional) (-k) Displays the disk space used in 1-K blocks (1024-byte units) instead of the default of 512-byte blocks. (Optional) (-p) Displays the disk space used in bytes (the default is 512-byte blocks). Also generates error messages for exiting files that cannot be displayed. (Optional) (-x) Displays information for the local device only. (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) Displays the disk space used for a device, directory, or file. The syntax for the source argument is device : / directory-path[/ filename] The device argument, followed by a colon, indicates the name of the device where the file is located. Use the online help (? ) function to display the available storage devices and network protocols. Enter the command without specifying a device, directory, or file to display information for the current directory, and subdirectories. (The command behaves as if the filename dot (.) is entered.) (Optional) Displays the UNIX options supported by this command. Command Default Information for the current directory is displayed. Command Modes EXEC Administration EXEC 20 OL

21 Utility Commands on the Cisco ASR 9000 Series Router utility du Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Enter the command without specifying a file to display information for the current directory. The command behaves as if the filename dot (.) is entered. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the kbytes keyword can also be entered using the UNIX-equivalent (-k). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples In the following example, the command is used to display the disk space used for the subdirectories in the MPLS package directory: RP/0/RSP0/CPU0:router# utility du file disk1:/asr9k-mpls i Tue Jul 28 03:20: DST 1607 /disk1:/asr9k-mpls i/schema 83 /disk1:/asr9k-mpls i/lib/cerrno 944 /disk1:/asr9k-mpls i/lib/mib 3434 /disk1:/asr9k-mpls i/lib /disk1:/asr9k-mpls i/bin 14 /disk1:/asr9k-mpls i/mib 14 /disk1:/asr9k-mpls i/placement 14 /disk1:/asr9k-mpls i/startup 1099 /disk1:/asr9k-mpls i/parser 18 /disk1:/asr9k-mpls i/configs 11 /disk1:/asr9k-mpls i/rules 14 /disk1:/asr9k-mpls i/partitions 156 /disk1:/asr9k-mpls i/etc/compat 164 /disk1:/asr9k-mpls i/etc 59 /disk1:/asr9k-mpls i/instdb_v 147 /disk1:/asr9k-mpls i/lc/bin 9 /disk1:/asr9k-mpls i/lc/startup 164 /disk1:/asr9k-mpls i/lc 103 /disk1:/asr9k-mpls i/instdb /disk1:/asr9k-mpls i OL

22 utility du Utility Commands on the Cisco ASR 9000 Series Router In the following example, the command is used to display the disk space used for a subdirectories: RP/0/RSP0/CPU0:router# utility du file disk0:/ asr9k -mpls-3.8.0/configs 37 /disk0:/asr9k-mpls-3.8.0/configs In the following example, the command is used to display the disk space used for the current working directory: RP/0/RSP0/CPU0:router# cd disk0:/ asr9k -mpls RP/0/RSP0/CPU0:router# utility du 160./schema 104./lib/cerrno 625./lib/mib 2545./lib 9658./bin 39./startup 840./parser 37./configs 35./mib 35./rules 34./partitions 135./etc/compat 167./etc 66./instdb_v 181./lc/bin 33./lc/startup 246./lc 112./instdb Related Commands Command utility df, page 16 Description Displays the amount of disk space available for a directory or file. 22 OL

23 Utility Commands on the Cisco ASR 9000 Series Router utility egrep utility egrep To search a file or the results of standard input using full regular expressions, use the utility egrep command in EXEC mode or administration EXEC mode. utility egrep {[expr expression script expression-file] [ WORD ] [count] [linenum] [matchfile] [matchline] [nocase] [nofile] [reverse] [file search-file] usage} Syntax Description expr expression script expression-file WORD count linenum matchfile matchline nocase nofile reverse file search-file usage (-e) A regular expression, whose type is determined by the -e and -f options. This form is used when only one expression is specified on the command line. Any names specified after this option are treated as input files. (-f) A file containing a set of regular expressions, each separated by a new line. The type of the expressions is determined by the -e and -f options. This form is used when more than one expression is specified. You can specify more than one -f option. The syntax of the expression-file argument is: [device :]/ filename (Optional) UNIX command-line option string. The maximum number of characters is 20. (Optional) (-c) Displays a count of selected lines. (Optional) (-n) Before each output line, displays the line's line number. (Optional) (-l) ( el ) Displays only the names of files containing the selected lines. (Optional) (-x) Includes only input lines selected against an entire fixed string or regular expression. (Optional) (-i) Ignores uppercase and lowercase distinctions during comparisons. (Optional) (-h) Displays results without a filename prefix attached to the matched lines. This option applies only when more than one file is searched. (Optional) (-v) Selects only those lines that don't match the specified patterns. (Optional) The file used for the search. Replace the search-file argument with the device and directory path of the file. The syntax for the search-file argument is: [device :]/ filename. (Optional) Displays the UNIX options supported by this command. Command Default If no files are specified, the keyboard input (standard input) is used. If more than one input file is specified, then the filename is displayed before each line. OL

24 utility egrep Utility Commands on the Cisco ASR 9000 Series Router Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. The grep utility searches files for character patterns using regular expressions and returns all lines that contain that pattern. The command uses full regular expressions (expressions using the full set of alphanumeric and special characters) to match the patterns. The results are displayed to the standard output (terminal screen). Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the count keyword can also be entered using the UNIX-equivalent (-c). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples In the following example, the command is used to locate the regular expression uptime. The linenum keyword is also entered to display the line number before each line of output. RP/0/RSP0/CPU0:router# show version utility egrep expr uptime linenum 7:router uptime is 5 days, 19 hours, 27 minutes In the following example, the command is used to locate a regular expression in a file. In this example, all lines with adm are displayed. The * character is used as a wildcard. RP/0/RSP0/CPU0:router# utility egrep expr Adm* nofile file disk0:/usr/passwd adm:x:4:4:admin:/var/adm: lp:x:71:8:line Printer Admin:/usr/spool/lp: uucp:x:5:5:uucp Admin:/usr/lib/uucp: nuucp:x:9:9:uucp Admin:/var/spool/uucppublic:/usr/lib/uucp/uucico listen:x:37:4:network Admin:/usr/net/nls: ssadmin:x:901218:60001:sun StorEdge(tm) Configuration Service Agent Admin:/:/bin/false 24 OL

25 Utility Commands on the Cisco ASR 9000 Series Router utility egrep In the following example, the nocase keyword is used to ignore the character case: RP/0/RSP0/CPU0:router# utility egrep expr Adm* nocase file disk0:/usr/passwd adm:x:4:4:admin:/var/adm: lp:x:71:8:line Printer Admin:/usr/spool/lp: uucp:x:5:5:uucp Admin:/usr/lib/uucp: nuucp:x:9:9:uucp Admin:/var/spool/uucppublic:/usr/lib/uucp/uucico listen:x:37:4:network Admin:/usr/net/nls: ssadmin:x:901218:60001:sun StorEdge(tm) Configuration Service Agent Admin:/:/bin/false In the following example, the linenum keyword is used to append the line number to the beginning of each output line: RP/0/RSP0/CPU0:router# utility egrep expr Adm* linenum file disk0:/usr/passwd 5:adm:x:4:4:Admin:/var/adm: 6:lp:x:71:8:Line Printer Admin:/usr/spool/lp: 7:uucp:x:5:5:uucp Admin:/usr/lib/uucp: 8:nuucp:x:9:9:uucp Admin:/var/spool/uucppublic:/usr/lib/uucp/uucico 9:listen:x:37:4:Network Admin:/usr/net/nls: 15:ssadmin:x:901218:60001:Sun StorEdge(tm) Configuration Service Agent Admin:/:/bin/false Related Commands Command utility fgrep, page 26 Description Searches a file for a fixed character string. OL

26 utility fgrep Utility Commands on the Cisco ASR 9000 Series Router utility fgrep To search a file for a fixed character string, use the utility fgrep command in EXEC mode or administration EXEC mode. utility fgrep {[expr expression script expression-file] [ WORD ] [count] [linenum] [matchfile] [matchline] [nocase] [nofile] [reverse] [file search-file] usage} Syntax Description expr expression script expression-file WORD count linenum matchfile matchline nocase nofile reverse file search-file usage (-e) A regular expression, whose type is determined by the -e and -f options. This form is used when only one expression is specified on the command line. Any names specified after this option are treated as input files. (-f) A file containing a set of regular expressions, each separated by a new line. The type of the expressions is determined by the -e and -f options. This form is used when more than one expression is specified. You can specify more than one -f option. The syntax of the expression-file filename argument is: device :[/ directory-path]/ (Optional) UNIX command-line option string. The maximum number of characters is 20. (Optional) (-c) Displays a count of selected lines. (Optional) (-n) Before each output line, displays the line's line number. (Optional) (-l) ( el ) Displays only the names of files containing the selected lines. (Optional) (-x) Includes only input lines selected against an entire fixed string or regular expression. (Optional) (-i) Ignores uppercase and lowercase distinctions during comparisons. (Optional) (-h) Displays results without a filename prefix attached to the matched lines. This option applies only when more than one file is searched. (Optional) (-v) Selects only those lines that don't match the specified patterns. (Optional) The file used for the search. Replace the search-file argument with the device and directory path of the file. The syntax for the search-file argument is: device :[/ directory-path]/ filename (Optional) Displays the UNIX options supported by this command. Command Default The keyboard input (standard input) is used if no files are specified. 26 OL

27 Utility Commands on the Cisco ASR 9000 Series Router utility fgrep If more than one input file is specified, then the filename is displayed before each line. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. The command searches files for a fixed character string (as opposed to grep and egrep, which search for a a pattern that matches an expression). The results are displayed to the standard output (terminal screen). Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. For example, the count keyword can also be entered using the UNIX-equivalent (-c). To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples The following example, the command is used with the nocase and linenum keywords: RP/0/RSP0/CPU0:router# show version utility fgrep expr uptime nocase linenum 7:router uptime is 5 days, 20 hours, 10 minutes Related Commands Command utility egrep, page 23 Description Searches a file using full regular expressions. OL

28 utility find Utility Commands on the Cisco ASR 9000 Series Router utility find To locate files within one or more directories, use the utility find command in EXEC mode or administration EXEC mode. utility find {path directory-path {LINE name filename-pattern user user-id} usage} Syntax Description path directory-path LINE name filename-pattern user user-id usage Specifies the storage device and directory for the file search. The search is performed for the specified directory and all subdirectories in that directory tree. If a directory path is not specified, then the search is performed in the current directory (a path of. [dot] is assumed). (Optional) UNIX command-line expressions provided as a string. (Optional) Searches for the name of the file. The filename-pattern argument is a regular expression string. (Optional) Searches for files belonging to a specific user. The user-id argument is the username of the file owner. (Optional) Displays the UNIX options supported by this command. Command Default If a directory path is not specified, then the search is performed in the current directory. If a name filename-pattern is not specified, then the search return all files in the specified directory. If a user is not specified, then the search is performed for all users. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Use the command to locate files within one or more directories. You can perform the search for a specific directory (and its subdirectories). If a directory is not specified, then the search is performed for the current directory. 28 OL

29 Utility Commands on the Cisco ASR 9000 Series Router utility find To search for a regular expression string, use the name filename-pattern keyword and argument. Replace the filename-pattern argument with the regular expression string. If this option is not used, then all files within the specified directory are displayed. To search for files belonging to a specific user, use the user-id argument. If this option is not used, then files belonging to all users are displayed. universal Operations execute Examples In the following example, the command is used to locate the file named asr9k-fwdg The path is the root directory of disk0:. RP/0/RP0/CPU0:router# utility find path disk0: name asr9k-fwdg disk0:/instdb/admin_pkgs_mdata/asr9k-fwdg disk0:/asr9k-fwdg In the following example, the command is used to locate files matching a pattern. In this example, all files ending in.txt are displayed: RP/0/RSP0/CPU0:router# utility find path disk0:/usr name *.txt disk0:/usr/test2.txt In the following example, the UNIX equivalent option is used to locate files matching a pattern. In this example, all files ending in.txt are displayed: RP/0/RSP0/CPU0:router# utility find path disk0: -name *.txt disk0:/asr9k-base-3.8.0/etc/vim/doc/editing.txt disk0:/asr9k-base-3.8.0/etc/vim/doc/help.txt disk0:/asr9k-base-3.8.0/etc/vim/doc/intro.txt disk0:/asr9k-base-3.8.0/etc/vim/doc/uganda.txt disk0:/usr/test2.txt In the following example, the files belonging to a specific user are displayed: RP/0/RSP0/CPU0:router# utility find path disk0:/usr user 0 disk0:/usr disk0:/usr/passwd disk0:/usr/test2.txt In the following example, the UNIX equivalent option is used to display files belonging to a specific user: RP/0/RSP0/CPU0:router# utility find path disk0:/usr -user 0 disk0:/usr disk0:/usr/passwd disk0:/usr/test2.txt OL

30 utility find Utility Commands on the Cisco ASR 9000 Series Router Related Commands Command utility which, page 48 Description Locates a program file. 30 OL

31 Utility Commands on the Cisco ASR 9000 Series Router utility head utility head To copy bytes or lines at the beginning of a file or from the standard input, use the utility head command in EXEC mode or administration EXEC mode. utilityhead[word [bytes] [count number][file source] usage] Syntax Description WORD bytes count number file source usage (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) (-c) Copies the data in bytes from the beginning of each specified file. The default setting is to copy lines of data. (Optional) (-n) Specifies the number of lines (default) or bytes to be copied. The number argument is an unsigned decimal integer. By default, the command copies the first ten units (lines or bytes) of the file. Use the count number option to change the default. (Optional) Specifies the storage device, directory, and filename for the files. If a file is not specified, the standard input is used. (Optional) Displays the UNIX options supported by this command. Command Default If the command is entered without keywords or arguments, the first ten lines of the file or standard output are copied. If no file is specified, then the standard input is used. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. The command copies the beginning bytes (default) or lines of one or more files to the standard output (usually the user interface display). Use the bytes or lines keywords to copy the data based on lines or bytes. Use the count number option to specify the number of bytes or lines to copy. By default, the command copies the first 10 lines of each file. OL

32 utility head Utility Commands on the Cisco ASR 9000 Series Router If more than one file is selected, an identifying header is added before the output for each file. If no file is specified, then the standard input (keyboard) is used. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples In the following example, the command is used to display the first 15 lines from the output of the show version command: RP/0/RSP0/CPU0:router# show version utility head count 15 Tue Jul 28 06:15: DST Cisco IOS XR Software, Version I[DT_IMAGE] Copyright (c) 2009 by Cisco Systems, Inc. ROM: System Bootstrap, Version 1.1( :183759) [ASR9K ROMMON], PE44_ASR-9010 uptime is 1 week, 6 days, 14 hours, 54 minutes System image file is "bootflash:disk0/asr9k-os-mbi i/mbiasr9k-rp.vm" cisco ASR9K Series (MPC8641D) processor with K bytes of memory. MPC8641D processor at 1333MHz, Revision Management Ethernet 12 TenGigE 40 GigabitEthernet In the following example, the command is entered with the bytes keyword. Only the first 15 bytes of output are displayed. RP/0/RSP0/CPU0:router# show version utility head count 15 bytes Cisco IOS XR S RP/0/RSP0/CPU0:router# Related Commands Command utility cut, page 6 utility sort, page 38 Description Cuts characters or lines from the output displayed from standard input or a file. Sorts, merges, or sequence-checks the output displayed from standard input or a file. 32 OL

33 Utility Commands on the Cisco ASR 9000 Series Router utility head Command utility tail, page 41 Description Copies the end portion of the output displayed from standard input or a file. OL

34 utility less Utility Commands on the Cisco ASR 9000 Series Router utility less To display a file page-by-page, use the utility less command in EXEC mode or administration EXEC mode. utility less {[exiteof] [ WORD ] nocase position line-number startat string} [file source-file] Syntax Description exiteof WORD nocase position line-number startat string file source-file (Optional) (-E) Automatically exits the utility the first time an end-of-file is encountered. (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) (-i) Ignores uppercase and lowercase distinctions during comparisons. (Optional) (-j) Uses the line at line-number on the screen to position matched lines during a patter search. (Optional) (-p) Starts at the first occurrence of the pattern specified by the string argument in the file. (Optional) Specifies the storage device and directory path for the text file to be displayed. The default is standard input. The syntax for the source-file argument is: device :[/ directory-path]/ filename Command Default If no text file is specified, standard input is assumed. Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Use the command to display files page by page. You can specify regular expressions for pattern matching using the startat keyword. You can scroll up as well as down. When you enter the less mode, commands are similar to the vi editor. 34 OL

35 Utility Commands on the Cisco ASR 9000 Series Router utility less Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. To display the UNIX-equivalent syntax online, enter the usage keyword. universal Operations execute Examples The following example, the command is used to display the file config_store. Only part of the file is shown here. RP/0/RSP0/CPU0:router# utility less file disk0:/usr/config_store Last configuration change at Tue Feb 20 18:34: by xxx! hostname H1 line console exec-timeout session-timeout 600! line default exec-timeout session-timeout 600!... OL

36 utility mv Utility Commands on the Cisco ASR 9000 Series Router utility mv To rename or move a file from one directory to another, use the utility mv command in EXEC mode or administration EXEC mode. utility mv {[WORD force interactive] source source-file target target-file usage} Syntax Description WORD force interactive source source-file target target-file usage (Optional) UNIX command-line option string. The maximum number of characters is 80. (Optional) (-f) Forces an overwrite if the target file already exists. There is no confirmation prompt. (Optional) (-i) Specifies to prompt for confirmation before renaming a file. Specifies the storage device, directory, and filename for the file to be moved. Specifies the new storage device, directory, and filename for the file. (Optional) Displays the UNIX options supported by this command. Command Default No default behavior or values Command Modes EXEC Administration EXEC Command History Release Release Modification This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Note Keywords are entered using the displayed syntax, or with UNIX-equivalent syntax. The UNIX-equivalent syntax is displayed in parentheses () in the syntax description. To display the UNIX-equivalent syntax online, enter the usage keyword. 36 OL