1#!/usr/bin/python
2r"""
3#############################################################
4#    @file     openbmc_ffdc_list.py
5#
6#    @brief    List for FFDC ( First failure data capture )
7#              commands and files to be collected as a part
8#              of the test case failure.
9#############################################################
10"""
11
12# -------------------
13# FFDC default list
14# -------------------
15
16# -----------------------------------------------------------------
17# Dict Name {  Index string : { Key String :  Comand string} }
18# -----------------------------------------------------------------
19# Add cmd's needed to be part of the ffdc report manifest file
20FFDC_BMC_CMD = {
21    'DRIVER INFO':
22    {
23        # String Name         Command
24        'FW Level': 'cat /etc/os-release',
25        'FW Timestamp': 'cat /etc/timestamp',
26    },
27    'BMC DATA':
28    {
29        'BMC OS': 'uname -a',
30        'BMC Uptime': 'uptime',
31        'BMC File System Disk Space Usage': 'df -hT',
32    },
33    'APPLICATION DATA':
34    {
35        'BMC state': '/usr/sbin/obmcutil state',
36    },
37}
38
39# Add file name and correcponding command needed for BMC
40FFDC_BMC_FILE = {
41    'BMC FILES':
42    {
43        # File Name         Command
44        'BMC_proc_list': 'top -n 1 -b',
45        'BMC_proc_fd_active_list': 'ls -Al /proc/*/fd/',
46        'BMC_journalctl_nopager': 'journalctl --no-pager',
47        'BMC_journalctl_pretty': 'journalctl -o json-pretty',
48        'BMC_dmesg': 'dmesg',
49        'BMC_procinfo': 'cat /proc/cpuinfo',
50        'BMC_meminfo': 'cat /proc/meminfo',
51    },
52}
53
54# Add file name and correcponding command needed for all Linux distributions
55FFDC_OS_ALL_DISTROS_FILE = {
56    'OS FILES':
57    {
58        # File Name         Command
59        'OS_msglog': 'cat /sys/firmware/opal/msglog',
60        'OS_cpufrequency': 'ppc64_cpu --frequency',
61        'OS_dmesg': 'dmesg',
62        'OS_boot': 'cat /var/log/boot.log',
63        'OS_procinfo': 'cat /proc/cpuinfo',
64        'OS_meminfo': 'cat /proc/meminfo',
65        'OS_netstat': 'netstat -a',
66        'OS_lspci': 'lspci',
67        'OS_lscpu': 'lscpu',
68        'OS_lscfg': 'lscfg',
69    },
70}
71
72# Add file name and correcponding command needed for Ubuntu Linux
73FFDC_OS_UBUNTU_FILE = {
74    'OS FILES':
75    {
76        # File Name         Command
77        'OS_isusb': 'lsusb -t ; lsusb -v',
78        'OS_kern': 'tail -n 50000 /var/log/kern.log',
79        'OS_authlog': 'cat /var/log/auth.log; cat /var/log/auth.log.1',
80        'OS_syslog': 'tail -n 200000 /var/log/syslog',
81        'OS_info': 'uname -a; dpkg -s opal-prd; dpkg -s ipmitool',
82    },
83}
84
85# Add file name and correcponding command needed for RHEL Linux
86FFDC_OS_RHEL_FILE = {
87    'OS FILES':
88    {
89        # File Name         Command
90        'OS_rsct': '/usr/bin/ctversion -bv',
91        'OS_secure': 'cat /var/log/secure',
92        'OS_syslog': 'tail -n 200000 /var/log/messages',
93        'OS_info': 'lsb_release -a; cat /etc/redhat-release; uname -a; rpm -qa',
94    },
95}
96
97# Add file name and correcponding command needed for RHEL Linux
98FFDC_OS_IBM_POWERKVM_FILE = {
99    'OS FILES':
100    {
101        # File Name         Command
102        'OS_secure': 'cat /var/log/secure',
103        'OS_syslog': 'tail -n 200000 /var/log/messages',
104        'OS_info': 'lsb_release -a; uname -a; rpm -qa',
105    },
106}
107
108OPENBMC_BASE = '/xyz/openbmc_project/'
109OPENPOWER_BASE = '/org/open_power/'
110ENUMERATE_SENSORS = OPENBMC_BASE + 'sensors/enumerate'
111ENUMERATE_INVENTORY = OPENBMC_BASE + 'inventory/enumerate'
112ENUMERATE_ELOG = OPENBMC_BASE + 'logging/entry/enumerate'
113ENUMERATE_LED = OPENBMC_BASE + 'led/enumerate'
114ENUMERATE_SW = OPENBMC_BASE + 'software/enumerate'
115ENUMERATE_CONTROL = OPENBMC_BASE + 'control/enumerate'
116ENUMERATE_OCC = OPENPOWER_BASE + 'control/enumerate'
117
118# Add file name and correcponding Get Request
119FFDC_GET_REQUEST = {
120    'GET REQUESTS':
121    {
122        # File Name         Command
123        'FIRMWARE_list': ENUMERATE_SW,
124        'BMC_sensor_list': ENUMERATE_SENSORS,
125        'BMC_control_list': ENUMERATE_CONTROL,
126        'BMC_inventory': ENUMERATE_INVENTORY,
127        'BMC_elog': ENUMERATE_ELOG,
128        'BMC_led': ENUMERATE_LED,
129        'OCC_state': ENUMERATE_OCC,
130    },
131}
132
133
134# Define your keywords in method/utils and call here
135FFDC_METHOD_CALL = {
136    'BMC LOGS':
137    {
138        # Description             Keyword name
139        'FFDC Generic Report': 'BMC FFDC Manifest',
140        'BMC Specific Files': 'BMC FFDC Files',
141        'Get Request FFDC': 'BMC FFDC Get Requests',
142        'OS FFDC': 'OS FFDC Files',
143        'Core Files': 'SCP Coredump Files',
144        'SEL Log': 'Collect eSEL Log',
145        'Sys Inventory Files': 'System Inventory Files',
146    },
147}
148
149# -----------------------------------------------------------------
150
151
152# base class for FFDC default list
153class openbmc_ffdc_list():
154
155    def get_ffdc_bmc_cmd(self, i_type):
156        r"""
157        ########################################################################
158        #   @brief    This method returns the list from the dictionary for cmds
159        #   @param    i_type: @type string: string index lookup
160        #   @return   List of key pair from the dictionary
161        ########################################################################
162        """
163        return FFDC_BMC_CMD[i_type].items()
164
165    def get_ffdc_bmc_file(self, i_type):
166        r"""
167        ########################################################################
168        #   @brief    This method returns the list from the dictionary for scp
169        #   @param    i_type: @type string: string index lookup
170        #   @return   List of key pair from the dictionary
171        ########################################################################
172        """
173        return FFDC_BMC_FILE[i_type].items()
174
175    def get_ffdc_get_request(self, i_type):
176        r"""
177        ########################################################################
178        #   @brief    This method returns the list from the dictionary for scp
179        #   @param    i_type: @type string: string index lookup
180        #   @return   List of key pair from the dictionary
181        ########################################################################
182        """
183        return FFDC_GET_REQUEST[i_type].items()
184
185    def get_ffdc_cmd_index(self):
186        r"""
187        ########################################################################
188        #   @brief    This method returns the list index from dictionary
189        #   @return   List of index to the dictionary
190        ########################################################################
191        """
192        return FFDC_BMC_CMD.keys()
193
194    def get_ffdc_get_request_index(self):
195        r"""
196        ########################################################################
197        #   @brief    This method returns the list index from dictionary
198        #   @return   List of index to the dictionary
199        ########################################################################
200        """
201        return FFDC_GET_REQUEST.keys()
202
203    def get_ffdc_file_index(self):
204        r"""
205        ########################################################################
206        #   @brief    This method returns the list index from dictionary
207        #   @return   List of index to the dictionary
208        ########################################################################
209        """
210        return FFDC_BMC_FILE.keys()
211
212    def get_ffdc_method_index(self):
213        r"""
214        ########################################################################
215        #   @brief    This method returns the key pair from the dictionary
216        #   @return   Index of the method dictionary
217        ########################################################################
218        """
219        return FFDC_METHOD_CALL.keys()
220
221    def get_ffdc_method_desc(self,
222                             index):
223        r"""
224        ########################################################################
225        #   @brief   This method returns the just the keys from the dictionary.
226        #   @return  List of ffdc descriptions.
227        ########################################################################
228        """
229        return FFDC_METHOD_CALL[index].keys()
230
231    def get_ffdc_method_call(self, i_type):
232        r"""
233        ########################################################################
234        #   @brief    This method returns the key pair from the dictionary
235        #   @return   List of key pair keywords
236        ########################################################################
237        """
238        return FFDC_METHOD_CALL[i_type].items()
239
240    def get_ffdc_os_all_distros_index(self):
241        r"""
242        ########################################################################
243        #   @brief    This method returns the key pair from the dictionary
244        #   @return   Index of the method dictionary
245        ########################################################################
246        """
247        return FFDC_OS_ALL_DISTROS_FILE.keys()
248
249    def get_ffdc_os_all_distros_call(self, i_type):
250        r"""
251        ########################################################################
252        #   @brief    This method returns the key pair from the dictionary
253        #   @return   List of key pair keywords
254        ########################################################################
255        """
256        return FFDC_OS_ALL_DISTROS_FILE[i_type].items()
257
258    def get_ffdc_os_distro_index(self, distro):
259        r"""
260        ########################################################################
261        #   @brief    This method returns the key pair from the dictionary
262        #   @return   Index of the method dictionary
263        ########################################################################
264        """
265        distro_file = "FFDC_OS_" + str(distro).upper() + "_FILE"
266        return eval(distro_file).keys()
267
268    def get_ffdc_os_distro_call(self, i_type, distro):
269        r"""
270        ########################################################################
271        #   @brief    This method returns the key pair from the dictionary
272        #   @return   List of key pair keywords
273        ########################################################################
274        """
275        distro_file = "FFDC_OS_" + str(distro).upper() + "_FILE"
276        return eval(distro_file)[i_type].items()
277
278    def get_strip_string(self, i_str):
279        r"""
280        ########################################################################
281        #   @brief    Returns the stripped strings
282        #   @param    i_str: @type string: string name
283        #   @return   Remove all special chars and return the string
284        ########################################################################
285        """
286        return ''.join(e for e in i_str if e.isalnum())
287
288    def get_esel_index(self, esel_list):
289        r"""
290        #######################################################################
291        #   @brief    Returns the eSEL binary index.
292        #   @param    esel_ist: @type list: eSEL list.
293        #   @return   Index of "ESEL=" in the list.
294        #######################################################################
295        """
296        index = [i for i, str in enumerate(esel_list) if 'ESEL=' in str]
297        return index[0]
298