3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.

2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
CiscoIOSConfigurationFundamentalsCommandReference,Release12.2

ConfigurationFileManagementCommands
CiscoIOSConfiguration
FundamentalsCommand
Reference,Release12.2
AbouttheCiscoIOS
DocumentationSet
UsingCiscoIOSSoftware
Part1:CiscoIOSUser
InterfacesCommands
Part2:FileManagement
Commands
CiscoIOSFileSystem(IFS)
Commands
ConfigurationFile
ManagementCommands
SystemImageand
MicrocodeCommands
RouterMemoryCommands
BootingCommands
BasicFileTransferServices
Commands
Part3:SystemManagement
Commands
Part4:Appendixes

Downloads:Thischapter

(PDF343.0KB)Thecompletebook

(PDF7.32MB)| Feedback

TableOfContents
ConfigurationFileManagementCommands
FlashMemoryFileSystemTypes
ReplacedCommands
bootbuffersize
bootconfig
boothost
bootnetwork
clearparsercache
configureterminal
configurememory
configureoverwritenetwork
parsercache
servicecompressconfig
serviceconfig
showconfiguration
showderivedconfig
showfile
showparserstatistics
showrunningconfig
showrunningconfigmapclass
showstartupconfig

ConfigurationFileManagementCommands
ThischapterprovidesdetaileddescriptionsofcommandsusedtomanageconfigurationfilesinCiscoIOSRelease12.2.Configurationfilescontaintheset
ofcommandsusedtocustomizethefunctionoftheCiscoIOSsoftware.
Forconfigurationinformationandexamples,refertothe"ManagingConfigurationFiles"chapterintheRelease12.2CiscoIOSConfiguration
FundamentalsConfigurationGuide.

FlashMemoryFileSystemTypes
CiscoplatformsgenerallyuseoneofthreedifferentFlashmemoryfilesystemtypes.Somecommandsaresupportedononlyoneortwofilesystemtypes.
Thischapternotescommandsthatarenotsupportedonallfilesystemtypes.
UseTable31todeterminewhichFlashmemoryfilesystemtypeyourplatformuses.

Table31FlashMemoryFileSystemTypes

Type Platforms
Class Cisco7000family,Cisco12000seriesrouters,LightStream1010switch
A
Class Cisco1003,Cisco1004,Cisco1005,Cisco2500series,Cisco3600series,andCisco4000seriesrouters,and
B
CiscoAS5200accessservers
Class CiscoMC3810multiserviceconcentrators,disk0ofCiscoSC3640SystemControllers
C

ReplacedCommands
Somecommandsfoundinthischapterinpreviousreleasesofthisbookhavebeenreplaced.Oldercommandsgenerallycontinuetoprovidethesame
functionalityinthecurrentrelease,butarenolongerdocumented.Supportfortheolderversionofthesecommandsmayalreadyberemovedonyour
system,ormayberemovedinafutureCiscoIOSsoftwarerelease.
Table32mapstheoldcommandstotheirreplacements.

Table32ReplacedCommands

Old
Command

NewCommand

configure
network

copyftp:[[[//[username[:password]@]location]/directory]/filename]system:runningconfig

configure
overwrite
network

copyftp:[[[//[username[:password]@]location]/directory]/filename]nvram:startupconfig

copyrcp
running
config

copyrcp:[[[//[username@]location]/directory]/filename]system:runningconfig

copy
running
configrcp

copysystem:runningconfigrcp:[[[//[username@]location]/directory]/filename]

copy
running
config
startup
config

copysystem:runningconfignvram:startupconfig

copy
running
configtftp

copysystem:runningconfigtftp:[[[//location]/directory]/filename]

copytftp
running
config

copytftp:[[[//location]/directory]/filename]system:runningconfig

copytftp
startup

copytftp:[[[//location]/directory]/filename]nvram:startupconfig

NoteThecopyrunningconfigstartupconfigcommandhasbeenreplacedbythecommandshown
here.However,thecopyrunningconfigstartupconfigcommandwillcontinuetobesupportedas
acommandaliasforthecopysystem:runningconfignvram:startupconfigcommand.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

1/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
config
erase
startup
config

erasenvram:

show
morenvram:startupconfig
configuration
showfile

more

show
running
config

moresystem:runningconfig
NoteTheshowrunningconfigcommandhasbeenreplacedbythecommandshownhere.However,the
showrunningconfigcommandwillcontinuetobesupportedasacommandaliasforthemore
system:runningconfigcommand.

show
startup
config

morenvram:startupconfig
NoteTheshowstartupconfigcommandhasbeenreplacedbythecommandshownhere.However,the
showstartupconfigcommandwillcontinuetobesupportedasacommandaliasforthemore
nvram:startupconfigcommand.

writeerase

erasenvram:

write
memory

copyrunningconfigstartupconfig
or
copysystem:runningconfignvram:startupconfig

write
network

copysystem:runningconfigftp:[[[//[username[:password]@]location]/directory]/filename]

write
terminal

showrunningconfig
or
moresystem:runningconfig

Formoreinformationaboutthesecommandreplacements,seethedescriptionoftheCiscoIOSFileSystem(IFS)inthe"UsingtheCiscoIOSFileSystem"
chapterintheRelease12.2CiscoIOSConfigurationFundamentalsConfigurationGuide.

bootbuffersize
Thebootbuffersizeglobalconfigurationcommandnolongerfunctions.
Executingthiscommandhasnoeffectonthesystem.UsingthiscommandwillnotgenerateCLIerrorsthebootbuffersizecommandsyntaxisstillallowed
tobeenteredattheCLIandinconfigurationfilesinordertoaccommodateexistingconfigurationscriptsusedbycustomers.

bootconfig
Tospecifythedeviceandfilenameoftheconfigurationfilefromwhichtherouterconfiguresitselfduringinitialization(startup),usethebootconfigglobal
configurationcommand.ThiscommandisonlyavailableonClassAfilesystemplatforms.Toremovethespecification,usethenoformofthiscommand.
bootconfigfilesystemprefix:[directory/]filename
nobootconfig
SyntaxDescription
filesystemprefix:

Filesystem,followedbyacolon(forexample,nvram:,flash:,orslot0:).

directory/

(Optional)Filesystemdirectorytheconfigurationfileislocatedin,followedbyaforwardslash(/).

filename

Nameoftheconfigurationfile.

Defaults
NVRAM(nvram:)
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

11.0

Thiscommandwasintroduced.

UsageGuidelines
ThiscommandisonlyavailableonClassAfilesystemplatforms.
YousettheCONFIG_FILEenvironmentvariableinthecurrentrunningmemorywhenyouusethebootconfigcommand.Thisvariablespecifiesthe
configurationfileusedforinitialization(startup).TheconfigurationfilemustbeanASCIIfilelocatedineitherNVRAMorFlashmemory.

NoteWhenyouusethisglobalconfigurationcommand,youaffectonlytherunningconfiguration.Youmustsavetheenvironmentvariablesettingtoyour
startupconfigurationtoplacetheinformationunderROMmonitorcontrolandtohavetheenvironmentvariablefunctionasexpected.Usethecopy
system:runningconfignvram:startupconfigcommandtosavetheenvironmentvariablefromyourrunningconfigurationtoyourstartupconfiguration.
ThesoftwaredisplaysanerrormessageanddoesnotupdatetheCONFIG_FILEenvironmentvariableinthefollowingsituations:

Youspecifynvram:asthefilesystem,anditcontainsonlyadistilledversionoftheconfiguration.(Adistilledconfigurationisonethatdoesnotcontain
accesslists.)

Youspecifyaconfigurationfileinthefilenameargumentthatdoesnotexistorisnotvalid.

TherouterusestheNVRAMconfigurationduringinitializationwhentheCONFIG_FILEenvironmentvariabledoesnotexistorwhenitisnull(suchasat
firsttimestartup).IfthesoftwaredetectsaproblemwithNVRAMortheconfigurationitcontains,thedeviceenterssetupmode.Seethe"SetupCommand"
chapterinthispublicationformoreinformationonthesetupcommandfacility.
Whenyouusethenoformofthiscommand,therouterreturnstousingthedefaultNVRAMconfigurationfileasthestartupconfiguration.
Examples
Inthefollowingexample,thefirstlinespecifiesthattheroutershouldusetheconfigurationfilenamedrouterconfiglocatedininternalFlashmemoryto
configureitselfduringinitialization.Thethirdlinecopiesthespecificationtothestartupconfiguration,ensuringthatthisspecificationwilltakeeffectupon
thenextreload.
Router(config)#bootconfigflash:routerconfig
Router(config)#end
Router#copysystem:runningconfignvram:startupconfig

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

2/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
ThefollowingexampleinstructsaCisco7500seriesroutertousetheconfigurationfilenamedrouterconfiglocatedontheFlashmemorycardinsertedin
thesecondPCMCIAslotoftheRSPcardduringinitialization.Thethirdlinecopiesthespecificationtothestartupconfiguration,ensuringthatthis
specificationwilltakeeffectuponthenextreload.
Router(config)#bootconfigslot1:routerconfig
Router(config)#end
Router#copysystem:runningconfignvram:startupconfig

RelatedCommands

Command Description
show
bootvar

DisplaysthecontentsoftheBOOTenvironmentvariable,thenameoftheconfigurationfilepointedtobythe
CONFIG_FILEenvironmentvariable,thecontentsoftheBOOTLDRenvironmentvariable,andthe
configurationregistersetting.

boothost
Tospecifythehostspecificconfigurationfiletobeusedatthenextsystemstartup,usetheboothostglobalconfigurationcommand.Torestorethehost
configurationfilenametothedefault,usethenoformofthiscommand.
boothostremoteurl
noboothostremoteurl
SyntaxDescription
remoteurl

Locationoftheconfigurationfile.Usethefollowingsyntax:

ftp:[[[//[username[:password]@]location]/directory]/filename]

rcp:[[[//[username@]location]/directory]/filename]

tftp:[[[//location]/directory]/filename]

Defaults
Ifyoudonotspecifyafilenameusingthiscommand,therouterusesitsconfiguredhostnametorequestaconfigurationfilefromaremoteserver.Toform
theconfigurationfilename,therouterconvertsitsnametoalllowercaseletters,removesalldomaininformation,andappendsconfgorconfig.
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
Thiscommandinstructsthesystemto"Bootusingnetworkconfigurationfilex,"wherexisthefilenamespecifiedintheremoteurlargument.Thiscommand
specifiestheremotelocationandfilenameofthenetworkconfigurationfiletobeusedatthenextsystemstartup,aswellastheprotocoltobeusedto
obtainthefile.
Whenbootingfromanetworkserver,routersignoreroutinginformation,staticIProutes,andbridginginformation.Asaresult,intermediateroutersare
responsibleforhandlingFTP,rcp,orTFTPrequests.Beforebootingfromanetworkserver,verifythataserverisavailablebyusingthepingcommand.
Usetheserviceconfigcommandtoenabletheloadingofthespecifiedconfigurationfileatreboottime.Withoutthiscommand,therouterignoresthe
networkcommandandusestheconfigurationinformationinNVRAM.IftheconfigurationinformationinNVRAMisinvalidormissing,theserviceconfig
commandisenabledautomatically.
Thenetworkserverwillattempttoloadtwoconfigurationfilesfromremotehosts.Thefirstisthenetworkconfigurationfilecontainingcommandsthatapply
toallnetworkserversonanetwork.Usethebootnetworkcommandtoidentifythenetworkconfigurationfile.Thesecondisthehostconfigurationfile
containingcommandsthatapplytoonenetworkserverinparticular.Usetheboothostcommandtoidentifythehostconfigurationfile.

NoteInreleasespriortoCiscoIOSRelease12.3(2)Tand12.3(1)B,theserviceconfigcommandisusedinconjunctionwiththeboothostorbootnetwork
command.Toenabletheroutertoautomaticallyconfigurethesystemfromthefilespecifiedbytheboothostorbootnetworkcommandyoumustenterthe
serviceconfigcommand.
WithCiscoIOSRelease12.3(2)T,12.3(1)B,andlater,younolongerhavetospecifytheserviceconfigcommandfortheboothostorbootnetwork
commandtobeactive.
Ifyouspecifyboththenoserviceconfigcommandandtheboothostcommand,therouterattemptstofindthespecifiedhostconfigurationfile.
Theserviceconfigcommandcanalsobeusedwithouttheboothostorbootnetworkcommand.Ifyoudonotspecifyhostornetworkconfiguration
filenames,therouterusesthedefaultconfigurationfiles.Thedefaultnetworkconfigurationfileisnetworkconfg.Thedefaulthostconfigurationfileis
confg,wherehostisthehostnameoftherouter.IftheCiscoIOSsoftwarecannotresolveitshostname,thedefaulthostconfigurationfileisrouterconfg
LoadingaConfigurationFileUsingrcp
Thercpsoftwarerequiresthataclientsendtheremoteusernameoneachrcprequesttothenetworkserver.Iftheserverhasadirectorystructure(suchas
UNIXsystems),thercpimplementationsearchesfortheconfigurationfilesstartinginthedirectoryassociatedwiththeremoteusername.
Whenyouloadaconfigurationfilefromaserverusingrcp,theCiscoIOSsoftwaresendsthefirstvalidusernameinthefollowinglist:
1. TheusernamespecifiedinthefileURL,ifausernameisspecified.
2. Theusernamesetbytheiprcmdremoteusernamecommand,ifthecommandisconfigured.
3. Therouterhostname.

NoteAnaccountfortheusernamemustbedefinedonthedestinationserver.Ifthenetworkadministratorofthedestinationserverdidnotestablishanaccount
fortheusername,thiscommandwillnotexecutesuccessfully.
LoadingaConfigurationFileUsingFTP
TheFTPprotocolrequiresaclienttosendaremoteusernameandpasswordoneachFTPrequesttoaserver.Theusernameandpasswordmustbe
associatedwithanaccountontheFTPserver.Iftheserverhasadirectorystructure,theconfigurationfileorimagecopiedfromthedirectoryassociated
withtheusernameontheserver.RefertothedocumentationforyourFTPserverformoredetails.
WhenyouloadaconfigurationfilefromaserverusingFTP,theCiscoIOSsoftwaresendsthefirstvalidusernameinthefollowinglist:
1. Theusernamespecifiedintheboothostcommand,ifausernameisspecified.
2. Theusernamesetbytheipftpusernamecommand,ifthecommandisconfigured.
3. Anonymous.
Theroutersendsthefirstvalidpasswordinthefollowinglist:
1. Thepasswordspecifiedintheboothostcommand,ifapasswordisspecified.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

3/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
2. Thepasswordsetbytheipftppasswordcommand,ifthecommandisconfigured.
3. Therouterformsapasswordusername@routername.domain.Thevariableusernameistheusernameassociatedwiththecurrentsession,
routernameistheconfiguredhostname,anddomainisthedomainoftherouter.
Examples
Thefollowingexamplesetsthehostfilenametowilmaconfgataddress192.168.7.19:
Router(config)#boothosttftp://192.168.7.19/usr/local/tftpdir/wilmaconfg
Router(config)#serviceconfig

RelatedCommands

Command

Description

boot
network

Specifiestheremotelocationandfilenameofthenetworkconfigurationfiletobeusedatthenextsystem
boot(startup).

service
config

Enablesautoloadingofconfigurationfilesfromanetworkserver.

bootnetwork
Tochangethedefaultnameofthenetworkconfigurationfilefromwhichtoloadconfigurationcommands,usethebootnetworkglobalconfiguration
command.Torestorethenetworkconfigurationfilenametothedefault,usethenoformofthiscommand.
bootnetworkremoteurl
nobootnetworkremoteurl
SyntaxDescription
remoteurl

Locationoftheconfigurationfile.Usethefollowingsyntax:

ftp:[[[//[username[:password]@]location]/directory]/filename]

rcp:[[[//[username@]location]/directory]/filename]

tftp:[[[//location]/directory]/filename]

Defaults
Thedefaultfilenameisnetworkconfig.
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
Thiscommandinstructsthesystemto"Bootusingnetworkconfigurationfilex,"wherexisthefilenamespecifiedintheremoteurlargument.Thiscommand
specifiestheremotelocationandfilenameofthenetworkconfigurationfiletobeusedatthenextsystemstartup,aswellastheprotocoltobeusedto
obtainthefile.
Whenbootingfromanetworkserver,routersignoreroutinginformation,staticIProutes,andbridginginformation.Asaresult,intermediateroutersare
responsibleforhandlingFTP,rcp,orTFTPrequests.Beforebootingfromanetworkserver,verifythataserverisavailablebyusingthepingcommand.
Usetheserviceconfigcommandtoenabletheloadingofthespecifiedconfigurationfileatreboottime.Withoutthiscommand,therouterignoresthe
networkcommandandusestheconfigurationinformationinNVRAM.IftheconfigurationinformationinNVRAMisinvalidormissing,theserviceconfig
commandisenabledautomatically.
Thenetworkserverwillattempttoloadtwoconfigurationfilesfromremotehosts.Thefirstisthenetworkconfigurationfilecontainingcommandsthatapply
toallnetworkserversonanetwork.Usethebootnetworkcommandtoidentifythenetworkconfigurationfile.Thesecondisthehostconfigurationfile
containingcommandsthatapplytoonenetworkserverinparticular.Usetheboothostcommandtoidentifythehostconfigurationfile.

NoteInreleasespriortoCiscoIOSRelease12.3(2)Tand12.3(1)B,theserviceconfigcommandisusedinconjunctionwiththeboothostorbootnetwork
command.Toenabletheroutertoautomaticallyconfigurethesystemfromthefilespecifiedbytheboothostorbootnetworkcommandyoumustenterthe
serviceconfigcommand.
WithCiscoIOSRelease12.3(2)T,12.3(1)B,andlater,younolongerhavetospecifytheserviceconfigcommandfortheboothostorbootnetwork
commandtobeactive.
Ifyouspecifyboththenoserviceconfigcommandandtheboothostcommand,therouterattemptstofindthespecifiedhostconfigurationfile.
Theserviceconfigcommandcanalsobeusedwithouttheboothostorbootnetworkcommand.Ifyoudonotspecifyhostornetworkconfiguration
filenames,therouterusesthedefaultconfigurationfiles.Thedefaultnetworkconfigurationfileisnetworkconfg.Thedefaulthostconfigurationfileis
confg,wherehostisthehostnameoftherouter.IftheCiscoIOSsoftwarecannotresolveitshostname,thedefaulthostconfigurationfileisrouterconfg
LoadingaConfigurationFileUsingrcp
Thercpsoftwarerequiresthataclientsendtheremoteusernameoneachrcprequesttothenetworkserver.Iftheserverhasadirectorystructure(suchas
UNIXsystems),thercpimplementationsearchesfortheconfigurationfilesstartinginthedirectoryassociatedwiththeremoteusername.
Whenyouloadaconfigurationfilefromaserverusingrcp,theCiscoIOSsoftwaresendsthefirstvalidusernameinthefollowinglist:
1. TheusernamespecifiedinthefileURL,ifausernameisspecified.
2. Theusernamesetbytheiprcmdremoteusernamecommand,ifthecommandisconfigured.
3. Therouterhostname.

NoteAnaccountfortheusernamemustbedefinedonthedestinationserver.Ifthenetworkadministratorofthedestinationserverdidnotestablishanaccount
fortheusername,thiscommandwillnotexecutesuccessfully.
LoadingaConfigurationFileUsingFTP
TheFTPprotocolrequiresaclienttosendaremoteusernameandpasswordoneachFTPrequesttoaserver.Theusernameandpasswordmustbe
associatedwithanaccountontheFTPserver.Iftheserverhasadirectorystructure,theconfigurationfileorimagecopiedfromthedirectoryassociated
withtheusernameontheserver.RefertothedocumentationforyourFTPserverformoredetails.
WhenyouloadaconfigurationfilefromaserverusingFTP,theCiscoIOSsoftwaresendsthefirstvalidusernameinthefollowinglist:
1. Theusernamespecifiedinthebootnetworkcommand,ifausernameisspecified.
2. Theusernamesetbytheipftpusernamecommand,ifthecommandisconfigured.
3. Anonymous.
Theroutersendsthefirstvalidpasswordinthefollowinglist:
1. Thepasswordspecifiedinthebootnetworkcommand,ifapasswordisspecified.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

4/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
2. Thepasswordsetbytheipftppasswordcommand,ifthecommandisconfigured.
3. Therouterformsapasswordusername@routername.domain.Thevariableusernameistheusernameassociatedwiththecurrentsession,
routernameistheconfiguredhostname,anddomainisthedomainoftherouter.
Examples
Thefollowingexamplechangesthenetworkconfigurationfilenametobridge_9.1andusesthedefaultbroadcastaddress:
Router(config)#bootnetworktftp:bridge_9.1
Router(config)#serviceconfig

Thefollowingexamplechangesthenetworkconfigurationfilenametobridge_9.1,specifiesthatrcpistobeusedasthetransportmechanism,andgives
172.16.1.111astheIPaddressoftheserveronwhichthenetworkconfigurationfileresides:
Router(config)#serviceconfig
Router(config)#bootnetworkrcp://172.16.1.111/bridge_9.1

RelatedCommands

Command Description
boothost

Specifiestheremotelocationandfilenameofthehostspecificconfigurationfiletobeusedatthenext
systemboot(startup).

service
config

Enablesautoloadingofconfigurationfilesfromaremotehost.

clearparsercache
Tocleartheparsecacheentriesandhit/missstatisticsstoredfortheParserCachefeature,usetheclearparsercachecommandinprivilegedEXEC
mode.
clearparsercache
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
Defaults
Nodefaultbehaviororvalues.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

12.1(5)T

Thiscommandwasintroduced.

UsageGuidelines
TheParserCachefeatureoptimizestheparsing(translationandexecution)ofCiscoIOSsoftwareconfigurationcommandlinesbyrememberinghowto
parserecentlyencounteredcommandlines,decreasingthetimerequiredtoprocesslargeconfigurationfiles.
TheclearparsercachecommandwillfreethesystemmemoryusedbytheParserCachefeatureandwillerasethehit/missstatisticsstoredfortheoutput
oftheshowparserstatisticsEXECcommand.ThiscommandisonlyeffectivewhentheParserCachefeatureisenabled.
Examples
Thefollowingexampleshowstheclearingoftheparsercache:
Router#showparserstatistics

Lastconfigurationfileparsed:NumberofCommands:1484,Time:820ms

Parsercache:enabled,1460hits,26misses
Router#clearparsercache
Router#showparserstatistics
Lastconfigurationfileparsed:NumberofCommands:1484,Time:820ms

Parsercache:enabled,0hits,1misses

RelatedCommands

Command

Description

parsercache

EnablesordisablestheParserCachefeature.

showparser
statistics

DisplaysstatisticsaboutthelastconfigurationfileparsedandthestatusoftheParserCache
feature.

configureterminal
Toenterglobalconfigurationmodeortoconfigurethesystemfromthesystemmemory,usetheconfigureterminalprivilegedEXECcommand.
configureterminal
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
Usethiscommandtoenterglobalconfigurationmode.Notethatcommandsinthismodearewrittentotherunningconfigurationfileassoonasyouenter
them(usingtheEnterkeyorCarriageReturn).
Afteryouentertheconfigurecommand,thesystempromptchangesfrom<routername>#to<routername>(config)#,indicatingthattherouterisin
globalconfigurationmode.ToleaveglobalconfigurationmodeandreturntotheprivilegedEXECprompt,typeendorpressCtrlZ.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

5/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
Toviewthechangestotheconfigurationyouhavemade,usethemoresystem:runningconfigcommandorshowrunningconfigcommandinEXEC
mode.
Examples
Inthefollowingexample,theuserentersglobalconfigurationmode:
Router#configure

Configuringfromterminal,memory,ornetwork[terminal]?terminal
Enterconfigurationcommands,oneperline.EndwithCNTL/Z.
Router(config)#

RelatedCommands

Command

Description

bootconfig

Specifiesthedeviceandfilenameoftheconfigurationfilefromwhichtherouter
configuresitselfduringinitialization(startup).

copysystem:runningconfig
nvram:startupconfig

Savestherunningconfigurationasthestartupconfigurationfile.

moresystem:runningconfig

Displaysthecurrentlyrunningconfiguration.

configurememory
Toconfigurethesystemfromthesystemmemory,usetheconfigurememoryprivilegedEXECcommand.
configurememory
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
OnallplatformsexceptClassAFlashfilesystemplatforms,thiscommandexecutesthecommandslocatedinintheconfigurationfileinNVRAM(the
"startupconfigurationfile").
OnClassAFlashfilesystemplatforms,ifyouspecifytheconfigurememorycommand,therouterexecutesthecommandspointedtobythe
CONFIG_FILEenvironmentvariable.TheCONFIG_FILEenvironmentvariablespecifiesthelocationoftheconfigurationfilethattherouterusesto
configureitselfduringinitialization.ThefilecanbelocatedinNVRAMoranyoftheFlashfilesystemssupportedbytheplatform.
WhentheCONFIG_FILEenvironmentvariablespecifiesNVRAM,therouterexecutestheNVRAMconfigurationonlyifitisanentireconfiguration,nota
distilledversion.Adistilledconfigurationisonethatdoesnotcontainaccesslists.
ToviewthecontentsoftheCONFIG_FILEenvironmentvariable,usetheshowbootvarEXECcommand.TomodifytheCONFIG_FILEenvironment
variable,usethebootconfigcommandandthensaveyourchangesbyissuingthecopysystem:runningconfignvram:startupconfigcommand.
Afteryouentertheconfigureterminalcommand,thesystempromptchangesfrom<routername>#to<routername>(config)#,indicatingthatthe
routerisinglobalconfigurationmode.ToleaveglobalconfigurationmodeandreturntotheprivilegedEXECprompt,usetheendcommand.
Examples
Inthefollowingexample,arouterisconfiguredfromtheconfigurationfileinthememorylocationpointedtobytheCONFIG_FILEenvironmentvariable:
Router#configurememory

RelatedCommands

Command

Description

bootconfig

Specifiesthedeviceandfilenameoftheconfigurationfilefromwhichtherouterconfiguresitself
duringinitialization(startup).

copy
system:running
config
nvram:startup
config

Savestherunningconfigurationasthestartupconfigurationfile.

showbootvar

DisplaysthecontentsoftheBOOTenvironmentvariable,thenameoftheconfigurationfilepointed
tobytheCONFIG_FILEenvironmentvariable,thecontentsoftheBOOTLDRenvironment
variable,andtheconfigurationregistersetting.

configureoverwritenetwork
Theconfigureoverwritenetworkhasbeenreplacedbythecopy{ftpurl|rcpurl|tftpurl}nvram:startupconfigcommand.Seethedescriptionofthe
copycommandinthe"CiscoIOSFileSystemCommands"chapterformoreinformation.

parsercache
ToreenabletheCiscoIOSsoftwareparsercacheafterdisablingit,usetheparsercacheglobalconfigurationcommand.Todisabletheparsercache,use
thenoformofthiscommand.
parsercache
noparsercache
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
Defaults
Parsercacheisenabledbydefault.
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

12.1(5)T

Thiscommandwasintroduced.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

6/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
UsageGuidelines
TheParserCachefeatureoptimizestheparsing(translationandexecution)ofCiscoIOSsoftwareconfigurationcommandlinesbyrememberinghowto
parserecentlyencounteredcommandlines,decreasingthetimerequiredtoprocesslargeconfigurationfiles.
Theparsercacheisenabledbydefault.However,ifyouwishtodisabletheparsercache,youmaydosousingthenoparsercachecommandinglobal
configurationmode.Toreenabletheparsercacheafterithasbeendisabled,usetheparsercachecommand.
Whenthenoparsercacheisissued,thecommandlineappearsintherunningconfigurationfile.However,iftheparsercacheisreenabled,nocommand
lineappearsintherunningconfigurationfile.
Examples
Inthefollowingexample,theCiscoIOSsoftwareParserCachefeatureisdisabled:
Router(config)#noparsercache

RelatedCommands

Command

Description

clearparsercache

Clearstheparsecacheentriesandhit/missstatisticsstoredfortheParserCachefeature.

showparser
statistics

DisplaysstatisticsaboutthelastconfigurationfileparsedandthestatusoftheParserCache
feature.

servicecompressconfig
Tocompressstartupconfigurationfiles,usetheservicecompressconfigglobalconfigurationcommand.Todisablecompression,usethenoformofthis
command.
servicecompressconfig
noservicecompressconfig
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
Defaults
Disabled
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
Afteryouconfiguretheservicecompressconfigcommand,therouterwillcompressconfigurationfileseverytimeyousaveaconfigurationtothestartup
configuration.Forexample,whenyouenterthecopysystem:runningconfignvram:startupconfigcommand,therunningconfigurationwillbe
compressedbeforestorageinNVRAM.
Ifthefilecompressionsucceeds,thefollowingmessageisdisplayed:
Compressingconfigurationfromconfigurationsizetocompressedsize
[OK]

IfthebootROMsdonotrecognizeacompressedconfiguration,thefollowingmessageisdisplayed:
BootROMsdonotsupportNVRAMcompressionConfigNOTwrittentoNVRAM

Ifthefilecompressionfails,thefollowingmessageisdisplayed:
Errortryingtocompressnvram

OnewaytodeterminewhetheraconfigurationfilewillbecompressedenoughtofitintoNVRAMistouseatexteditortoentertheconfiguration,thenuse
theUNIXcompresscommandtocheckthecompressedsize.Togetacloserapproximationofthecompressionratio,usetheUNIXcompressb12
command.
Oncetheconfigurationfilehasbeencompressed,therouterfunctionsnormally.Atboottime,thesystemrecognizesthattheconfigurationfileis
compressed,uncompressesit,andproceedsnormally.Apartitionnvram:startupconfigcommanduncompressestheconfigurationbeforedisplayingit.
Todisablecompressionoftheconfigurationfile,enterconfigurationmodeandspecifythenoservicecompressconfigcommand.Then,exitglobal
configurationmodeandenterthecopysystem:runningconfignvram:startupconfigcommand.TherouterdisplaysanOKmessageifitisabletowrite
theuncompressedconfigurationtoNVRAM.Otherwise,therouterdisplaysanerrormessageindicatingthattheconfigurationistoolargetostore.Ifthe
configurationfileislargerthanthephysicalNVRAM,thefollowingmessageisdisplayed:
##ConfigurationtoolargetofituncompressedinNVRAMTruncateconfiguration?[confirm]

Whenthefileistruncated,commandsattheendofthefileareerased.Therefore,youwilllosepartofyourconfiguration.Totruncateandsavethe
configuration,typeY.Tonottruncateandnotsavetheconfiguration,typeN.
Examples
Inthefollowingexample,theconfigurationfileiscompressed:
Router#configureterminal
Enterconfigurationcommands,oneperline.EndwithCNTL/Z.
Router(config)#servicecompressconfig
Router(config)#end
Router#
%SYS5CONFIG_I:Configuredfromconsolebyconsole
Router#copysystem:runningconfignvram:startupconfig
Buildingconfiguration...
Compressingconfigurationfrom1179bytesto674bytes
[OK]

RelatedCommands

Command

Description

partitionnvram:startupconfig

SeparatesFlashmemoryintopartitionsonClassBfilesystemplatforms.

serviceconfig
Toenableautoloadingofconfigurationfilesfromanetworkserver,usetheserviceconfigglobalconfigurationcommand.Torestorethedefault,usethe

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

7/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
formofthiscommand.
serviceconfig
noserviceconfig
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
Defaults
Disabled,exceptonsystemswithoutNVRAMorwithinvalidorincompleteinformationinNVRAM.Inthesecases,autoloadingofconfigurationfilesfroma
networkserverisenabledautomatically.
CommandModes
Globalconfiguration
CommandHistory

Release

Modification

10.0

Thiscommandwasintroduced.

UsageGuidelines
Usually,theserviceconfigcommandisusedinconjunctionwiththeboothostorbootnetworkcommand.Youmustentertheserviceconfigcommandto
enabletheroutertoautomaticallyconfigurethesystemfromthefilespecifiedbytheboothostorbootnetworkcommand.
WithIOSsoftwareversions12.3(2)T,12.3(1)B,andlater,younolongerhavetospecifytheserviceconfigcommandfortheboothostorbootnetwork
commandtobeactive.
Ifyouspecifyboththenoserviceconfigcommandandtheboothostcommand,therouterattemptstofindthespecifiedhostconfigurationfile.Theservice
configcommandcanalsobeusedwithouttheboothostorbootnetworkcommand.Ifyoudonotspecifyhostornetworkconfigurationfilenames,the
routerusesthedefaultconfigurationfiles.Thedefaultnetworkconfigurationfileisnetworkconfg.Thedefaulthostconfigurationfileishostconfg,where
hostisthehostnameoftherouter.IftheCiscoIOSsoftwarecannotresolveitshostname,thedefaulthostconfigurationfileisrouterconfg.
Examples
Inthefollowingexample,arouterisconfiguredtoautoloadthedefaultnetworkandhostconfigurationfiles.Becausenoboothostorbootnetwork
commandsarespecified,therouterusesthebroadcastaddresstorequestthefilesfromaTFTPserver.
Router(config)#serviceconfig

Thefollowingexamplechangesthenetworkconfigurationfilenametobridge_9.1,specifiesthatrcpistobeusedasthetransportmechanism,andgives
172.16.1.111astheIPaddressoftheserveronwhichthenetworkconfigurationfileresides:
Router(config)#serviceconfig
Router(config)#bootnetworkrcp://172.16.1.111/bridge_9.1

RelatedCommands

Command

Description

boothost

Changesthedefaultnameofthehostconfigurationfilenamefromwhichtoloadconfigurationcommands.

bootnetwork Changesthedefaultnameofthenetworkconfigurationfilefromwhichtoloadconfigurationcommands.

showconfiguration
Theshowconfigurationcommandhasbeenreplacedbytheshowstartupconfigandmorenvram:startupconfigcommands.Seethedescriptionof
themorecommandinthe"CiscoIOSFileSystemCommands"chapterformoreinformation.

showderivedconfig
Todisplaythecompositeresultsofalltheconfigurationcommandsthatapplytoaninterface,includingcommandsthatcomefromsourcessuchasstatic
templates,dynamictemplates,dialerinterfaces,andauthentication,authorization,andaccounting(AAA)peruserattributes,usetheshowderivedconfig
commandinprivilegedEXECmode.
showderivedconfig[interfacetypenumber]
SyntaxDescription
interface
type
number

(Optional)Displaysthederivedconfigurationforaspecificinterface.Ifyouusetheinterfacekeyword,you
mustspecifytheinterfacetypeandtheinterfacenumber(forexample,interfaceethernet0).

CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

12.1

Thiscommandwasintroduced.

UsageGuidelines
Configurationcommandscanbeappliedtoaninterfacefromsourcessuchasstatictemplates,dynamictemplatesboundbyresourcepooling,dialer
interfaces,AAAperuserattributesandtheconfigurationofthephysicalinterface.Theshowderivedconfigcommanddisplaysallthecommandsthat
applytoaninterface.
Theoutputfortheshowderivedconfigcommandisnearlyidenticaltothatoftheshowrunningconfigcommand.Itdifferswhentheconfigurationforan
interfaceisderivedfromatemplate,adialerinterface,orsomeperuserconfiguration.Inthosecases,thecommandsderivedfromthetemplate,dialer
interface,andsoon,willbedisplayedfortheaffectedinterface.
Ifthesamecommandisconfigureddifferentlyintwodifferentsourcesthatapplytothesameinterface,thecommandcomingfromthesourcethathasthe
highestprecedencewillappearinthedisplay.
Examples
Thefollowingexamplesshowsampleoutputfortheshowrunningconfigandshowderivedconfigcommandsforserialinterface0:23anddialer
interface0.Theoutputoftheshowrunningconfigandshowderivedconfigcommandsisthesamefordialerinterface0becausenoneofthecommands
thatapplytothatinterfacearederivedfromanysourcesotherthantheconfigurationofthedialerinterface.Theoutputfortheshowrunningconfig
showderivedconfigcommandsforserialinterface0:23differsbecausesomeofthecommandsthatapplytoserialinterface0:23comefromdialer
interface0.
Router#showrunningconfiginterfaceSerial0:23

Buildingconfiguration...

Currentconfiguration:296bytes
!

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

8/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
interfaceSerial0:23
descriptionPRItoADTRAN(#4444150)
ipunnumberedLoopback0
encapsulationppp
dialerrotarygroup0
isdnswitchtypeprimarydms100
isdnincomingvoicemodem
isdncallingnumber4444150
peerdefaultipaddresspoolold_pool
end

Router#showrunningconfiginterfaceDialer0

Buildingconfiguration...

Currentconfiguration:257bytes
!
interfaceDialer0
descriptionDialinUsers
ipunnumberedLoopback0
noipproxyarp
encapsulationppp
dialerinband
dialeridletimeout30
dialergroup1
peerdefaultipaddresspoolnew_pool
pppauthenticationpapchapcallin
end

Router#showderivedconfiginterfaceSerial0:23

Buildingconfiguration...

Derivedconfiguration:332bytes
!
interfaceSerial0:23
descriptionPRItoADTRAN(#4444150)
ipunnumberedLoopback0
encapsulationppp
dialerrotarygroup0
isdnswitchtypeprimarydms100
isdnincomingvoicemodem
isdncallingnumber4444150
peerdefaultipaddresspoolnew_pool
pppauthenticationpapchapcallin
end

Router#showderivedconfiginterfaceDialer0

Buildingconfiguration...

Derivedconfiguration:257bytes
!
interfaceDialer0
descriptionDialinUsers
ipunnumberedLoopback0
noipproxyarp
encapsulationppp
dialerinband
dialeridletimeout30
dialergroup1
peerdefaultipaddresspoolnew_pool
pppauthenticationpapchapcallin
end

RelatedCommands

Command

Description

showrunning
config

Displaysthecontentsofthecurrentlyrunningconfigurationfileortheconfigurationforaspecific
interface.

showfile
Theshowfilecommandhasbeenreplacedbythemorecommand.Seethedescriptionofthemorecommandinthe"CiscoIOSFileSystemCommands"
chapterformoreinformation.

showparserstatistics
TodisplaysstatisticsaboutthelastconfigurationfileparsedandthestatusoftheParserCachefeature,usetheshowparserstatisticscommandin
privilegedEXECmode.
showparserstatistics
SyntaxDescription
Thiscommandhasnoargumentsorkeywords.
Defaults
Nodefaultbehaviororvalues.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

12.1(5)T

Thiscommandwasintroduced.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

9/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
UsageGuidelines
Theshowparserstatisticscommanddisplaystwosetsofdata:

Thenumberofcommandsintheconfigurationfilethatwaslastcopiedintotherunningconfiguration,andthetimeittookforthesystemtoparsethem
(aconfigurationfilecanbeloadedintotherunningconfigurationatsystemstartup,orbyissuingcommandssuchasthecopysourcerunningconfig
command).

ThestatusoftheParserCachefeature(enabledordisabled)andthenumberofcommandmatches(indicatedbyhits/misses)sincethesystemwas
startedorsincetheparsercachewascleared.

TheParserCachefeatureoptimizestheparsing(translationandexecution)ofCiscoIOSsoftwareconfigurationcommandlinesbyrememberinghowto
parserecentlyencounteredcommandlines,decreasingthetimerequiredtoprocesslargeconfigurationfiles.
Examples
Thefollowingexampleshowssampleoutputfromtheshowparserstatisticscommand:
Router#showparserstatistics

Lastconfigurationfileparsed:NumberofCommands:1484,Time:1272ms

Parsercache:disabled,0hits,2misses

Inthisexample,theParserCachefeatureisdisabled,butshowsthehit/missstatisticsforthetwocommandsissuedwhiletheparsercachewaslast
enabled.
Table33describesthekeyoutputfields:

Table33showparserstatisticsOutputFields

Last
configuration Displaysstatisticsonthelastconfigurationfilecopiedintotherunningconfiguration(atstartupor
fileparsed:
usingthecopycommand).
Numberof
commands:

Thenumberofcommandlinesinthelastconfigurationfileparsed.

Time:

Time(inmilliseconds)takenforthesystemtoloadthelastconfigurationfile.

Parsercache: DisplayswhethertheParserCachefeatureisenabledordisabled,andthehit/missstatisticsrelatedtothe
feature.Statisticsarestoredsincetheinitializationofthesystem,orsincethelasttimetheparsercache
wascleared.
hits

Numberofcommandstheparsercachewasabletoparsemoreefficientlybymatchingthemtosimilar
commandsexecutedpreviously.

misses

Numberofcommandstheparsercachewasunabletomatchtopreviouslyexecutedcommands.The
performanceenhancementprovidedbytheParserCachefeaturecannotbeappliedtounmatched
commands.

InthefollowingexampletheshowparserstatisticscommandisusedtocomparetheparsetimeofalargeconfigurationfilewiththeParserCache
featuredisabledandenabled.Inthisexample,aconfigurationfilewith1484accesslistcommandsisloadedintotherunningconfiguration.
Router#configureterminal
!parsercacheisdisabled
Router(config)#noparsercache
!configurationfileisloadedintotherunningconfiguration
Router#copyslot0:acl_listrunningconfig
...
Router#showparserstatistics
Lastconfigurationfileparsed:NumberofCommands:1484,Time:1272ms

Parsercache:disabled,0hits,2misses

!theparsercacheisreenabled
Router(config)#parsercache
!configurationfileisloadedintotherunningconfiguration
Router#copyslot0:acl_listrunningconfig
...
Router#showparserstatistics
Lastconfigurationfileparsed:NumberofCommands:1484,Time:820ms

Parsercache:enabled,1460hits,26misses

Theseresultsshowanimprovementtotheloadtimeforthesameconfigurationfilefrom1272milliseconds(ms)to820mswhentheParserCachefeature
wasenabled.Asindicatedinthe"hits"fieldoftheshowcommandoutput,1460commandswereabletobeparsedmoreefficientlybytheparsercache.
RelatedCommands

Command

Description

clearparsercache

Clearstheparsecacheentriesandhit/missstatisticsstoredfortheParserCachefeature.

parsercache

EnablesordisablestheParserCachefeature.

showrunningconfig
Todisplaythecontentsofthecurrentlyrunningconfigurationfileortheconfigurationforaspecificclassmap,interface,mapclass,policymap,orvirtual
circuit(VC)class,usetheshowrunningconfigcommandinprivilegedEXECmode.
showrunningconfig[options]
SyntaxDescription
options (Optional)Oneofthefollowingoptionscanbeenteredwiththecommand:

briefDisplaystheconfigurationwithoutcertificationdata.

classmapnameDisplaysclassmapinformation.Thelinenumkeywordcanbeusedwiththeclassmap
nameoption.

fullDisplaysthefullconfiguration.

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

10/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel

interfacetypenumberDisplaysinterfacespecificconfigurationinformation.Ifyouusetheinterface
keyword,youmustspecifytheinterfacetypeandtheinterfacenumber(forexample,interfaceethernet0).
Commoninterfacesincludeasync,ethernet,fastEthernet,groupasync,loopback,null,serial,and
virtualtemplate.Usetheshowruninterface?commandtodeterminetheinterfacesavailableonyour
system.

linenumDisplayslinenumbersintheoutput.Thebrieforfullkeywordcanbeusedwiththelinenum
keyword.

mapclassDisplaysmapclassinformation.Thisoptionisdescribedseparatelyseetheshowrunning
configmapclasscommandpage.

policymapnameDisplayspolicymapinformation.Thelinenumkeywordcanbeusedwiththepolicymap
nameoption.

vcclassnameDisplaysVCclassinformation(displayavailableonlyonlimitedrouterssuchastheCisco
7500series).Thelinenumkeywordcanbeusedwiththevcclassnameoption.

|Allowsadditionofoutputmodifiersandisavailablewithallthekeywordsforthiscommand.

Defaults
Theshowrunningconfigcommandwithoutanyargumentsorkeywordsdisplaystheentirecontentsoftherunningconfigurationfile.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

11.0

Thiscommandwasintroduced.

12.0

Thiscommandwasreplacedbythemoresystem:runningconfigcommand.

12.0(1)T

Theoutputmodifier(|)wasadded.

12.2(4)T

Thelinenumkeywordwasadded.

UsageGuidelines
Theshowrunningconfigcommandistechnicallyacommandaliasofthemoresystem:runningconfigcommand.Althoughmorecommandsare
recommended(duetotheiruniformstructureacrossplatformsandtheirexpandablesyntax),theshowrunningconfigcommandremainsenabledto
accommodateitswidespreaduse,andtoallowtypingshortcutssuchasshowrun.
Theshowrunningconfiginterfacecommandisusefulwhentherearemultipleinterfacesandyouwanttolookattheconfigurationofaspecificinterface.
Thelinenumkeywordcauseslinenumberstobedisplayedintheoutput.Thisoptionisusefulforidentifyingaparticularportionofaverylarge
configuration.
Examples
Thefollowingexampleshowstheconfigurationforserialinterface1:
Router#showrunningconfiginterfaceserial1

Buildingconfiguration...

Currentconfiguration:
!
interfaceSerial1
noipaddress
noipdirectedbroadcast
noiproutecache
noipmroutecache
shutdown
end

ThefollowingexampleshowstheconfigurationforEthernetinterface0/0.Linenumbersaredisplayedintheoutput.
Router#showrunningconfiginterfaceethernet0/0linenum

Buildingconfiguration...

Currentconfiguration:104bytes
1:!
2:interfaceEthernet0/0
3:ipaddress10.4.2.63255.255.255.0
4:noiproutecache
5:noipmroutecache
6:end

Thefollowingexampleshowshowtosetlinenumbersinthecommandoutput,andthenusetheoutputmodifiertostartthedisplayatline10:
Router#showrunningconfiglinenum|begin10
10:bootstartmarker
11:bootendmarker
12:!
13:nologgingbuffered
14:enablepassword#####
15:!
16:spe1/01/7
17:firmwarelocationbootflash:micamodempw.2.7.1.0.bin
18:!
19:!
20:resourcepooldisable
21:!
22:noaaanewmodel
23:ipsubnetzero
24:ipdomainnamecisco.com
25:ipnameserver172.16.11.48
26:ipnameserver172.16.2.133
27:!
28:!
29:isdnswitchtypeprimary5ess

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

11/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
30:!
.
.
.
126:end

RelatedCommandsdocrtr5302#showrunningconflinenum|begin10
RelatedCommands10:bootstartmarker
RelatedCommands11:bootendmarker
RelatedCommands12:!
RelatedCommands13:nologgingbuffered
RelatedCommands14:enablepassword#1writer
RelatedCommands15:!
RelatedCommands16:spe1/01/7
RelatedCommands17:firmwarelocationbootflash:micamodempw.2.7.1.0.bin
RelatedCommands18:!
RelatedCommands19:!
RelatedCommands20:resourcepooldisable
RelatedCommands21:!
RelatedCommands22:noaaanewmodel
RelatedCommands23:ipsubnetzero
RelatedCommands24:ipdomainnamecisco.com
RelatedCommands25:ipnameserver172.16.11.48
RelatedCommands26:ipnameserver172.16.2.133
RelatedCommands27:!
RelatedCommands28:!
RelatedCommands29:isdnswitchtypeprimary5ess
RelatedCommands30:!
RelatedCommands31:!
RelatedCommands

Command

Description

bootconfig

Specifiesthedeviceandfilenameoftheconfigurationfilefromwhichtherouterconfiguresitselfduring
initialization(startup).

configure
terminal

Entersglobalconfigurationmode.

copyrunning
configstartup
config

Copiestherunningconfigurationtothestartupconfiguration.(Commandaliasforthecopy
system:runningconfignvram:startupconfigcommand.)

showrunning
Displaysonlymapclassconfigurationinformationfromtherunningconfigurationfile.
configmapclass
showstartup
config

DisplaysthecontentsofNVRAM(ifpresentandvalid)ordisplaystheconfigurationfilepointedtoby
theCONFIG_FILEenvironmentvariable.(Commandaliasforthemore:nvramstartupconfig
command.)

showrunningconfigmapclass
Todisplayonlymapclassconfigurationinformationfromtherunningconfigurationfile,usetheshowrunningconfigmapclassprivilegedEXEC
command.
showrunningconfigmapclass[atm[mapclassname]|dialer[mapclassname]|framerelay[mapclassname]]
SyntaxDescription
atm

(Optional)DisplaysonlyATMmapclassconfigurationlines.

dialer

(Optional)Displaysonlydialermapclassconfigurationlines.

framerelay

(Optional)DisplaysonlyFrameRelaymapclassconfigurationlines.

mapclassname

(Optional)Displaysonlyconfigurationlinesforthespecifiedmapclass.

Defaults
Displaysallmapclassconfigurationintherunningconfigurationfile.
CommandModes
PrivilegedEXEC
CommandHistory

Release Modification
12.1

Themapclassextensiontotheshowrunningconfigcommandwasintroducedtoshowonlylinespertaining
todialerorFrameRelaymapclasses.

12.1(2)T Theatm,dialer,andframerelaykeywordsandmapclassnameargumentwereintroduced.

UsageGuidelines
Usetheshowrunningconfigmapclasscommandtodisplaythefollowinginformationfromtherunningconfigurationfile:

Allmapclassesconfiguredontherouter.

MapclassesconfiguredspecificallyforATM,FrameRelay,ordialer.

AspecificATM,FrameRelay,ordialermapclass.

Examples
Thefollowingoutputexamplesassumethatauserhasconfigured2FrameRelaymapclassesnamed"cir60"and"cir70,"1ATMmapclassnamed
"vc100,"and1dialermapclassnamed"dialer1."
AllMapClassesConfiguredontheRouterExample

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

12/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
Router#showrunningconfigmapclass

Buildingconfiguration...
Currentconfiguration:
!
mapclassframerelaycir60
framerelaybc16000
framerelayadaptiveshapingbecn
!
mapclassframerelaycir70
noframerelayadaptiveshaping
framerelayprioritygroup2
!
mapclassatmvc100
atmaal5mux
!
mapclassdialerdialer1
dialeridletimeout10
end

AllFrameRelayMapClassesExample
Router#showrunningconfigmapclassframerelay

Buildingconfiguration...
Currentconfiguration:
!
mapclassframerelaycir60
framerelaybc16000
framerelayadaptiveshapingbecn
!
mapclassframerelaycir70
noframerelayadaptiveshaping
framerelayprioritygroup2
end

ASpecificMapClassExample
Router#showrunningconfigmapclassframerelaycir60

Buildingconfiguration...
Currentconfiguration:
!
mapclassframerelaycir60
framerelaybc16000
framerelayadaptiveshapingbecn
end

RelatedCommands

Command

Description

mapclassatm

SpecifiestheATMmapclassforanSVC.

mapclassdialer

Definesaclassofsharedconfigurationparametersassociatedwiththedialermapcommandfor
outgoingcallsfromanISDNinterfaceandforPPPcallback.

mapclassframe SpecifiesamapclasstodefineQoSvaluesforaFrameRelayVC.
relay
more
system:running
config

Displayscontentsofthecurrentlyrunningconfigurationfile(equivalenttotheshowrunningconfig
command.)

showstartupconfig
Todisplaythecontentsoftheconfigurationfilethatwillbeusedatthenextsystemstartup,usetheshowstartupconfigormorenvram:startupconfig
commandinPrivilegedEXECmode.
showstartupconfig[|{begin|exclude|include}string]
SyntaxDescription
|beginstring

(Optional)Begintheoutputfromthefirstlinetomatchthespecifiedstring.Thepipe(|)isrequired.

|excludestring (Optional)Excludefromtheoutputanylinethatmatchesthespecifiedstring.Thepipe(|)isrequired.
|includestring

(Optional)Displaysonlylinesthatmatchthespecifiedstring.Thepipe(|)isrequired.

Defaults
None.
CommandModes
PrivilegedEXEC
CommandHistory

Release

Modification

11.0

Thiscommandwasintroduced.

UsageGuidelines
TheshowstartupconfigcommanddisplaysthecontentsofNVRAM(ifpresentandvalid)ordisplaystheconfigurationfilepointedtobythe
CONFIG_FILEenvironmentvariable.
Aswithallshowcommands,youcanspecifytheoutputyouareinterestedinmorepreciselyusingthepipe(|)optioncombinedwiththebegin,include
andexcludekeywords.Formoreinformationontheseoptions,seethedocumentationofthemorebegin,moreexclude,moreinclude,showbegin
showexclude,andshowincludecommands.
InCiscoIOSRelease12.0theshowstartupconfigcommandwasdeprecatedinfavorofthemorenvram:startupconfigcommand.Althoughmore

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

13/14

3/29/2016 CiscoIOSConfigurationFundamentalsCommandReference,Release12.2ConfigurationFileManagementCommands[CiscoIOSSoftwareRel
commandsarerecommended(duetotheiruniformstructureacrossplatformsandtheirexpandablesyntax),theshowstartupconfigcommandremains
enabledtoaccommodateitswidespreaduse,andtoallowtypingshortcutssuchasshowstart.
RelatedCommands

Command

Description

bootconfig

Specifiesthedeviceandfilenameoftheconfigurationfilefromwhichtherouterconfiguresitself
duringinitialization(startup).

copyrunningconfig
startupconfig

Copiestherunningconfigurationtothestartupconfiguration.(Commandaliasforthecopy
system:runningconfignvram:startupconfigcommand.)

Terms&Conditions|PrivacyStatement|CookiePolicy|Trademarks

http://www.cisco.com/c/en/us/td/docs/ios/12_2/configfun/command/reference/ffun_r/frf007.html

14/14