The cl-support script replicates the /etc directory.

Files that cl-support deliberately excludes are:


nologin prevents unprivileged users from logging into the system.


update-alternatives creates, removes, maintains and displays information about the symbolic links comprising the Debian alternatives system.

This is the alphabetical of the output from running ls -l on the /etc directory structure created by cl-support. The green highlighted rows are the ones Cumulus Networks finds most important when troubleshooting problems.

FileDescriptionWhy is this important?
acpiAdvanced configuration and power interface files. This directory is present only on x86 systems. 

The file /etc/adduser.conf contains defaults for the programs adduser, addgroup, deluser, and delgroup.


Corrects the time to synchronize the system clock.


apt (Advanced Package Tool) is the command-line tool for handling packages. This folder contains all the configurations.

apt interactions or unsupported apps can affect machine performance.

The directory that contains audisp-remote.conf, which is the file that controls the audit remote logging subsystem configuration.



The directory that contains the /etc/audit/auditd.conf, which contains configuration information specific to the audit daemon. 
bash.bashrcBash is an sh-compatible command language interpreter that executes commands read from standard input or from a file. 
bash_completionThis points to /usr/share/bash-completion/bash_completion. 
bash_completion.dThis folder contains app-specific code for Bash completion on Cumulus Linux, such as mstpctl. 
bcm.dBroadcom-specific ASIC file structure (hardware interaction). If there are questions, contact the Cumulus Networks Support team. This is unique to Cumulus Linux. 

This file contains a list of port numbers between 600 and 1024, which should not be used by bindresvport.

binfmt.dFor configuring additional binary formats for executables at boot. 
ca-certificatesThe folder for ca-certificates. It is empty by default on Cumulus Linux; see below for more information. 

Each lines list the pathname of activated CA certificates under /usr/share/ca-certificates.

calendarThe system-wide default calendar file. 
chefThis is an example of something that is not included by default. In this instance, cl-support included the chef folder for some reason.This is not installed by default, but this tool could have been installed or configured incorrectly, which is why it's included in the cl-support output.

cron is a daemon that executes scheduled commands.

cron.dailySee above. 
cron.hourlySee above. 
cron.monthlySee above. 
cron.weeklySee above. 
crontabSee above. 
cruftDebian housecleaning tool. 

This directory contains the following:

  • ACL information, stored in the acl directory.
  • switchd configuration file, switchd.conf.
  • qos, which is under the datapath directory.
  • The routing protocol process priority, nice.conf.
  • The breakout cable configuration, under ports.conf.
This folder is specific to Cumulus Linux and does not exist on other Linux platforms. For example, while you can configure iptables, to hardware accelerate rules into the hardware you need to use cl-acltool and have the rules under the /etc/cumulus/acl/policy.d/<filename.rules)
dbus-1Message bus for sending messages between applications. 
debconf.confDebconf is a configuration system for Debian packages. 

The complete Debian version string.

debsums-ignoredebsums verifies installed package files against their MD5 checksums. This file identifies the packages to ignore. 
defaultThis folder contains files with configurable flags for many different applications (most installed by default or added manually). For example, /etc/default/networking has a flag for EXCLUDE_INTERFACES=, which is set to nothing by default, but a user could change it to something like swp3. 
deluser.confThe file /etc/deluser.conf contains defaults for the programs deluser and delgroup. 
dhcpThis directory contains DHCP-specific information. 
discover.conf.dConfiguration directory for hardware detection utility. 
discover-modprobe.confConfiguration file for Linux discover-modprobe utility, which retrieves and loads kernel modules. 
dnsmasq.confdnsmasq configuration file. 
dnsmasq.dDirectory of dnsmasq configuration files. 
dpkgThe package manager for Debian. 
e2fsck.confThe configuration file for e2fsck. It controls the default behavior of e2fsck while it checks ext2, ext3 or ext4 filesystems. 
environmentUtilized by pam_env for setting and unsetting environment variables. 
etckeeperDirectory of files for etckeeper, which enables /etc to be stored in a repository. 
ethertypesThis file can be used to show readable characters instead of hexadecimal numbers for the protocols. For example, 0x0800 will be represented by IPv4. 
frrContains the configuration files for the FRRouting suite, the preferred Cumulus Linux routing engine. 
fstabStatic information about the filesystems. 
fstab.dThe directory that can contain additional fstab information; it is empty by default. 
fw_env.configConfiguration file utilized by U-Boot. The file is present only on ARM systems. 
gai.confConfiguration file for sorting the return information from getaddrinfo. 
groffThe directory containing information for groffer, an application used for displaying Unix man pages. 

The /etc/group file is a text file that defines the groups on the system.

group-Backup for the /etc/group file. 
grub.dDirectory of GRUB configuration files. 
gshadow/etc/gshadow contains the shadowed information for group accounts. 
gshadow-Backup for the /etc/gshadow file. 
hostapdDirectory for host AP driver files. Used for 802.1X interfaces. 

802.1X configuration settings. This file is generated automatically.

host.confResolver configuration file, which contains options like multi that determines whether /etc/hosts will respond with multiple entries for DNS names. 
hostnameThe system host name, such as leaf1, spine1, sw1. 
hostsThe static table lookup for hostnames. 
hosts.allowThe part of the host_access program for controlling a simple access control language. hosts.allow=Access is granted when a daemon/client pair matches an entry. 
hosts.denySee hosts.allow above, except that access is denied when a daemon/client pair matches an entry. 
hsflowd.confConfiguration file for the hsflowd daemon that samples and sends sFlow data to configured collectors. 
hw_init.dCumulus Linux/Cumulus VX hardware-specific tools. 
image-releaseContains the version of Cumulus Linux that was installed with the installer. This version number does not change when you upgrade using apt-get.Useful for determining baseline version.
initDefault location of the system job configuration files. 
init.dIn order for a service to start when the switch boots, you should add the necessary script to the director here. The differences between init and init.d are explained well here. 
initramfs-toolsContains tools for creating an initramfs. 
inputrcThe initialization file utilized by readline. 
insservThis application enables installed system init scripts; this directory is empty by default. 
insserv.confConfiguration file for insserv. 
insserv.conf.dAdditional directory for insserv configurations. 
iproute2Directory containing values for the Linux command line tool ip. 
issue/etc/issue is a text file that contains a message or system identification to be printed before the login prompt. 
issue.netIdentification file for telnet sessions. 
kbdLinux console font and keytable utilities. 
kernelKernel executable files. a compiled list of candidate libraries previously found in the augmented library path. by the ldconfig tool, which configures dynamic linker run-time bindings. directory that contains additional configuration (see above). 
ldapThe directory containing the ldap.conf configuration file used to set the system-wide default to be applied when running LDAP clients. 
libaudit.confConfiguration file utilized by get_auditfail_action. 
libnlDirectory for the configuration relating to the libnl library, which is the core library for implementing the fundamentals required to use the netlink protocol such as socket handling, message construction and parsing, and sending and receiving of data. 
lldpd.dDirectory containing configuration files whose commands are executed by lldpcli at startup. 
locale.aliasLocale name alias database. 
locale.genLocale definitions. 
localtimeCopy of the original data file for /etc/timezone. 

Directory containing logcheck.conf and logfiles utilized by the log check program, which scans system logs for interesting lines.

login.defsShadow password suite configuration. 
logrotate.confRotates, compresses and mails system logs. 
logrotate.dDirectory containing additional log rotate configurations. 
lsb-releaseShows the current version of Linux on the system. Run cat /etc/lsb-release for output.This shows you the version of the operating system you are running; also compare this to the output of onie-select.
lvmConfiguration for local volume manager. 
machine-idLocal machine ID. 
magicUsed by the file command to determine file type. magic tests check for files with data in particular fixed formats. 
magic.mimeThe magic MIME type causes the file command to output MIME type strings rather than the more traditional human readable ones. 
mailcapThe mailcap file is read by the metamail program to determine how to display non-text at the local site. 
mailcap.orderThe order of entries in the /etc/mailcap file can be altered by editing the /etc/mailcap.order file. 
manpath.configThe manpath configuration file is used by the manual page utilities to assess users’ manpaths at run time, to indicate which manual page hierarchies (manpaths) are to be treated as system hierarchies and to assign them directories to be used for storing cat files. 
mcelogMachine check event log. The file is present only on x86 systems. 
mime.typesMIME type description file for cups. 
mke2fs.confConfiguration file for mke2fs, which is a program that creates an ext, ext3 or ext4 filesystem. 

Mellanox-specific ASIC file structure (hardware interaction). If there are questions, contact the Cumulus Networks Support team. This is unique to Cumulus Linux.

modprobe.dConfiguration directory for modprobe, which is a utility that can add and remove modules from the Linux kernel. 
modulesThe kernel modules to load at boot time. 
modules-load.dConfiguration for modules to load at system boot. 
motdThe contents of /etc/motd ("message of the day") are displayed by pam_motd after a successful login but just before it executes the login shell. 
motd.distribGeneric message of the day for Debian. 
mtabThe programs mount and umount maintain a list of currently mounted filesystems in the /etc/mtab file. If no arguments are given to mount, this list is printed. 
mysqlMySQL configuration file. 
nanorcThe GNU nano rcfile. 
netd.confThe NCLU configuration file.Contains the settings for which Linux commands are operable under NCLU. Also contains the blacklist of infrequently used commands.
networkContains the network interface configuration for ifup and ifdown.The main configuration file is under /etc/network/interfaces. This is where you configure L2 and L3 information for all of your front panel ports (swp interfaces). Settings like MTU, link speed, IP address information, and VLANs are all included here.
networksNetwork name information. 
nsswitch.confSystem databases and name service switch configuration file. 
ntp.confNTP (network time protocol) server configuration file. 
openvswitchThe directory containing the conf.db file, which is used by ovsdb-server. 
openvswitch-vtepConfiguration files used for the VTEP daemon and ovsdb-server. 
optHost-specific configuration files for add-on applications installed in /opt. 
os-releaseOperating system identification. 
pam.confThe PAM (pluggable authentication module) configuration file. When a PAM-aware privilege granting application is started, it activates its attachment to the PAM-API. This activation performs a number of tasks, the most important being the reading of the configuration file(s). 
pam.dAlternate directory to configure PAM (see above). 
pam_radius.confConfiguration file for RADIUS. This file is present only if a RADIUS client is installed. 
passwdUser account information. 
passwd-Backup file for /etc/passwd. 
perlPerl is an available scripting language. /etc/perl contains configuration files specific to Perl. 
popularity-contest.confConfiguration for package popularity information. 
profile/etc/profile is utilized by sysprofile, a modular centralized shell configuration. 
profile.dThe directory version of the above, which contains configuration files. 
protocolsThe protocols definition file, a plain ASCII file that describes the various DARPAnet protocols that are available from the TCP/IP subsystem. 
ptm.dThe directory containing scripts that are run if PTM passes or fails.Cumulus Linux-specific folder for PTM (prescriptive topology manager).
pythonPython is an available scripting language. 
python2.6The 2.6 version of python. 
python2.7The 2.7 version of python. 
python3The 3.0 version of python. 
python3.4The 3.4 version of python. 
rc.localThe /etc/rc.local script is used by the system administrator to execute after all the normal system services are started, at the end of the process of switching to a multiuser runlevel. You can use it to start a custom service, for example, a server that's installed in /usr/local. Most installations don't need /etc/rc.local; it's provided for the minority of cases where it's needed. 
rc0.dLike rc.local, these scripts are booted by default, but the number of the folder represents the Linux runlevel. This folder 0 represents runlevel 0 (halt the system). 
rc1.dThis is run level 1, which is single-user/minimal mode. 
rc2.dRunlevels 2 through 5 are multiuser modes. Debian systems (such as Cumulus Linux) come with id=2, which indicates that the default runlevel will be 2 when the multi-user state is entered, and the scripts in /etc/rc2.d/ will be run. 
rc3.dSee above. 
rc4.dSee above. 
rc5.dSee above. 
rc6.dRunlevel 6 is reboot the system. 
rcS.dS stands for single and is equivalent to rc1. 
rdnbrd.confRedistribute neighbor configuration file. 
resolvconfResolver configuration file directory. 
resolv.confResolver configuration file, which is where DNS is set (domain, nameserver and search).You need DNS to reach the Cumulus Linux repository.
rmtThis is not a mistake. The shell script /etc/rmt is provided for compatibility with other Unix-like systems, some of which have utilities that expect to find (and execute) rmt in the /etc directory on remote systems. 
rpcThe rpc file contains human-readable names that can be used in place of RPC program numbers. 
rsyslog.confThe rsyslog.conf file is the main configuration file for rsyslogd, which logs system messages on *nix systems. 
rsyslog.dThe directory containing additional configuration for rsyslog.conf (see above). 
screenrcSystem screen settings. 
securettyThis file lists terminals into which the root user can log in. 
securityThe /etc/security directory contains security-related configurations files. Whereas PAM concerns itself with the methods used to authenticate any given user, the files under /etc/security are concerned with just what a user can or cannot do. For example, the /etc/security/access.conf file contains a list of which users are allowed to log in and from what host (for example, using telnet). The /etc/security/limits.conf file contains various system limits, such as maximum number of processes. 
selinuxNSA Security-Enhanced Linux. 
sensors.dThe directory from which the sensors program loads its configuration; this is unique for each hardware platform. See also Monitoring System Hardware. 
sensors3.confThe sensors.conf file describes how libsensors, and thus all programs using it, should translate the raw readings from the kernel modules to real-world values. 
servicesservices is a plain ASCII file providing a mapping between human-readable textual names for internet services and their underlying assigned port numbers and protocol types. 

shadow is a file that contains the password information for the system's accounts and optional aging information.

shadow-The backup for the /etc/shadow file. 
shellsThe pathnames of valid login shells. 
skelThe skeleton directory (usually /etc/skel) is used to copy default files and also sets a umask for the creation used by pam_mkhomedir. 
snmpInterface functions to the SNMP (simple network management protocol) toolkit. 
sshThe ssh configuration. 
sslThe OpenSSL ssl library implements the Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1) protocols. This directory holds certificates and configuration. 
staff-group-for-usr-localUse cat or more on this file to learn more information, see 
subgidSubordinate gid file, for group IDs. 
subgid-The backup for the /etc/subgid file. 
subuidSubordinate uid file, for user IDs. 
subuid-The backup for the /etc/subuid file. 
sudoersThe sudoers policy plugin determines a user's sudo privileges. 
sudoers.dThe directory file containing additional sudoers configuration (see above). 
sysctl.confConfigures kernel parameters at boot. 
sysctl.dThe directory file containing additional configuration (see above). 
systemdsystemd system and service manager. 
tacplus_nss.confBasic configuration file for TACACS+ and the libnss_tacplus package. This file is present only if the TACACS+ client is installed on the system. 
tacplus_serversTACACS+ server configuration file. This file is present only if the TACACS+ client is installed on the system. 
terminfoTerminal capability database. 
timezoneIf this file exists, it is read and its contents are used as the time zone name. 
ucf.confThe update configuration file preserves user changes in configuration files. 
udevDynamic device management. 
ufwProvides both a command line interface and a framework for managing a netfilter firewall. 
vimConfiguration file for command line tool vim. 
vrfConfiguration for services to run in a VRF context. 
vxrd.confLNV registration node configuration file. 
vxsnd.confLNV service node node configuration file. 
watchdog.confHardware watchdog configuration file. 
wgetrcConfiguration file for command line tool wget. 
X11Keyboard configuration. 
xdgDefault configuration files.