1b1b4d261SWilliam A. Kennington IIIdescription: > 2a1347418SPatrick Williams This interface contains a Create method, which can be implemented to allow 3a1347418SPatrick Williams creation of xyz.openbmc_project.Logging.Entry objects directly over D-Bus, 4a1347418SPatrick Williams without needing the errors defined in the *.Error/metadata.yaml files. 5b1b4d261SWilliam A. Kennington III 6b1b4d261SWilliam A. Kennington IIImethods: 7b1b4d261SWilliam A. Kennington III - name: Create 8b1b4d261SWilliam A. Kennington III description: > 9b1b4d261SWilliam A. Kennington III Create a xyz.openbmc_project.Logging.Entry object. 10b1b4d261SWilliam A. Kennington III parameters: 11b1b4d261SWilliam A. Kennington III - name: Message 12b1b4d261SWilliam A. Kennington III type: string 13b1b4d261SWilliam A. Kennington III description: > 14b1b4d261SWilliam A. Kennington III The Message property of the event entry. 15b1b4d261SWilliam A. Kennington III - name: Severity 16b1b4d261SWilliam A. Kennington III type: enum[xyz.openbmc_project.Logging.Entry.Level] 17b1b4d261SWilliam A. Kennington III description: > 18b1b4d261SWilliam A. Kennington III The Severity property of the event entry. 19b1b4d261SWilliam A. Kennington III - name: AdditionalData 20b1b4d261SWilliam A. Kennington III type: dict[string, string] 21b1b4d261SWilliam A. Kennington III description: > 22a1347418SPatrick Williams The AdditionalData property of the event entry. e.g.: 23b1b4d261SWilliam A. Kennington III { 24b1b4d261SWilliam A. Kennington III "key1": "value1", 25b1b4d261SWilliam A. Kennington III "key2": "value2" 26b1b4d261SWilliam A. Kennington III } 27b1b4d261SWilliam A. Kennington III ends up in AdditionaData like: 28b1b4d261SWilliam A. Kennington III ["KEY1=value1", "KEY2=value2"] 29b1b4d261SWilliam A. Kennington III 30b1b4d261SWilliam A. Kennington III - name: CreateWithFFDCFiles 31b1b4d261SWilliam A. Kennington III description: > 32b1b4d261SWilliam A. Kennington III Create an xyz.openbmc_project.Logging.Entry object and pass in an 33b1b4d261SWilliam A. Kennington III array of file descriptors for files that contain FFDC (first failure 34b1b4d261SWilliam A. Kennington III data capture) data which may be used by event log extensions that 35a1347418SPatrick Williams support storing it with their event logs. The other arguments are the 36a1347418SPatrick Williams same as with Create(). The FFDC argument is ignored by the base 37a1347418SPatrick Williams phosphor-logging event logs. 38b1b4d261SWilliam A. Kennington III 39b1b4d261SWilliam A. Kennington III When the method call is complete the descriptors must be closed and 40b1b4d261SWilliam A. Kennington III the files can be deleted if desired. 41b1b4d261SWilliam A. Kennington III parameters: 42b1b4d261SWilliam A. Kennington III - name: Message 43b1b4d261SWilliam A. Kennington III type: string 44b1b4d261SWilliam A. Kennington III description: > 45b1b4d261SWilliam A. Kennington III The Message property of the event entry. 46b1b4d261SWilliam A. Kennington III - name: Severity 47b1b4d261SWilliam A. Kennington III type: enum[xyz.openbmc_project.Logging.Entry.Level] 48b1b4d261SWilliam A. Kennington III description: > 49b1b4d261SWilliam A. Kennington III The Severity property of the event entry. 50b1b4d261SWilliam A. Kennington III - name: AdditionalData 51b1b4d261SWilliam A. Kennington III type: dict[string, string] 52b1b4d261SWilliam A. Kennington III description: > 53a1347418SPatrick Williams The AdditionalData property of the event entry. e.g.: 54b1b4d261SWilliam A. Kennington III { 55b1b4d261SWilliam A. Kennington III "key1": "value1", 56b1b4d261SWilliam A. Kennington III "key2": "value2" 57b1b4d261SWilliam A. Kennington III } 58b1b4d261SWilliam A. Kennington III ends up in AdditionaData like: 59b1b4d261SWilliam A. Kennington III ["KEY1=value1", "KEY2=value2"] 60b1b4d261SWilliam A. Kennington III - name: FFDC 61b1b4d261SWilliam A. Kennington III type: array[struct[enum[self.FFDCFormat], byte, byte, unixfd]] 62b1b4d261SWilliam A. Kennington III description: > 63a1347418SPatrick Williams File descriptors for any files containing FFDC, along with 64a1347418SPatrick Williams metadata about the contents: 65b1b4d261SWilliam A. Kennington III 66b1b4d261SWilliam A. Kennington III FFDCFormat- The format type of the contained data. 67b1b4d261SWilliam A. Kennington III subType - The format subtype, used for the 'Custom' type. 68a1347418SPatrick Williams version - The version of the data format, used for the 69a1347418SPatrick Williams 'Custom' 70b1b4d261SWilliam A. Kennington III type. 71b1b4d261SWilliam A. Kennington III unixfd - The file descriptor to the data file. 72b1b4d261SWilliam A. Kennington III 73a1347418SPatrick Williams e.g.: [ 74a1347418SPatrick Williams {"xyz.openbmc_project.Logging.Create.FFDCFormat.JSON", 0, 0, 75a1347418SPatrick Williams 5}, 76a1347418SPatrick Williams {"xyz.openbmc_project.Logging.Create.FFDCFormat.Custom", 1, 2, 77a1347418SPatrick Williams 6} ] 78b1b4d261SWilliam A. Kennington III 79b1b4d261SWilliam A. Kennington IIIenumerations: 80b1b4d261SWilliam A. Kennington III - name: FFDCFormat 81b1b4d261SWilliam A. Kennington III description: > 82b1b4d261SWilliam A. Kennington III format types 83b1b4d261SWilliam A. Kennington III values: 84b1b4d261SWilliam A. Kennington III - name: JSON 85b1b4d261SWilliam A. Kennington III description: > 86b1b4d261SWilliam A. Kennington III Valid fully formed JSON, e.g. {"foo":"bar"} 87b1b4d261SWilliam A. Kennington III - name: CBOR 88b1b4d261SWilliam A. Kennington III description: > 89b1b4d261SWilliam A. Kennington III Valid CBOR (Concise Binary Object Representation) 90b1b4d261SWilliam A. Kennington III - name: Text 91b1b4d261SWilliam A. Kennington III description: > 92b1b4d261SWilliam A. Kennington III ASCII text 93b1b4d261SWilliam A. Kennington III - name: Custom 94b1b4d261SWilliam A. Kennington III description: > 95b1b4d261SWilliam A. Kennington III Something other than the above formats 96*6c25fd02SPatrick Williams 97*6c25fd02SPatrick Williamsservice_names: 98*6c25fd02SPatrick Williams - default: xyz.openbmc_project.Logging 99*6c25fd02SPatrick Williams 100*6c25fd02SPatrick Williamspaths: 101*6c25fd02SPatrick Williams - instance: /xyz/openbmc_project/logging 102