| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 1 | //===- PdbYAML.h ---------------------------------------------- *- C++ --*-===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
| 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
| 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | |
| 10 | #ifndef LLVM_TOOLS_LLVMPDBDUMP_PDBYAML_H |
| 11 | #define LLVM_TOOLS_LLVMPDBDUMP_PDBYAML_H |
| 12 | |
| 13 | #include "OutputStyle.h" |
| 14 | |
| 15 | #include "llvm/ADT/Optional.h" |
| Zachary Turner | 3b14764 | 2016-10-08 01:12:01 +0000 | [diff] [blame] | 16 | #include "llvm/DebugInfo/CodeView/SymbolRecord.h" |
| 17 | #include "llvm/DebugInfo/CodeView/TypeRecord.h" |
| Zachary Turner | a3225b0 | 2016-07-29 20:56:36 +0000 | [diff] [blame] | 18 | #include "llvm/DebugInfo/MSF/MSFCommon.h" |
| Adrian McCarthy | 6b6b8c4 | 2017-01-25 22:38:55 +0000 | [diff] [blame] | 19 | #include "llvm/DebugInfo/PDB/Native/PDBFile.h" |
| 20 | #include "llvm/DebugInfo/PDB/Native/RawConstants.h" |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 21 | #include "llvm/DebugInfo/PDB/PDBTypes.h" |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 22 | #include "llvm/Support/Endian.h" |
| 23 | #include "llvm/Support/YAMLTraits.h" |
| 24 | |
| 25 | #include <vector> |
| 26 | |
| 27 | namespace llvm { |
| 28 | namespace pdb { |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 29 | |
| 30 | namespace yaml { |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 31 | struct SerializationContext; |
| 32 | |
| Zachary Turner | a3225b0 | 2016-07-29 20:56:36 +0000 | [diff] [blame] | 33 | struct MSFHeaders { |
| Zachary Turner | faa554b | 2016-07-15 22:16:56 +0000 | [diff] [blame] | 34 | msf::SuperBlock SuperBlock; |
| Zachary Turner | ea4e607 | 2017-03-15 22:18:53 +0000 | [diff] [blame] | 35 | uint32_t NumDirectoryBlocks = 0; |
| Zachary Turner | faa554b | 2016-07-15 22:16:56 +0000 | [diff] [blame] | 36 | std::vector<uint32_t> DirectoryBlocks; |
| Zachary Turner | ea4e607 | 2017-03-15 22:18:53 +0000 | [diff] [blame] | 37 | uint32_t NumStreams = 0; |
| 38 | uint32_t FileSize = 0; |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 39 | }; |
| 40 | |
| Zachary Turner | 1dc9fd3 | 2016-06-14 20:48:36 +0000 | [diff] [blame] | 41 | struct StreamBlockList { |
| Zachary Turner | faa554b | 2016-07-15 22:16:56 +0000 | [diff] [blame] | 42 | std::vector<uint32_t> Blocks; |
| Zachary Turner | 25e8b05 | 2016-06-06 20:37:17 +0000 | [diff] [blame] | 43 | }; |
| 44 | |
| Zachary Turner | 5e534c7 | 2016-07-15 22:17:08 +0000 | [diff] [blame] | 45 | struct NamedStreamMapping { |
| 46 | StringRef StreamName; |
| 47 | uint32_t StreamNumber; |
| 48 | }; |
| 49 | |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 50 | struct PdbInfoStream { |
| Zachary Turner | ea4e607 | 2017-03-15 22:18:53 +0000 | [diff] [blame] | 51 | PdbRaw_ImplVer Version = PdbImplVC70; |
| 52 | uint32_t Signature = 0; |
| 53 | uint32_t Age = 1; |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 54 | PDB_UniqueId Guid; |
| Zachary Turner | 05d5e61 | 2017-03-16 20:19:11 +0000 | [diff] [blame] | 55 | std::vector<PdbRaw_FeatureSig> Features; |
| Zachary Turner | 5e534c7 | 2016-07-15 22:17:08 +0000 | [diff] [blame] | 56 | std::vector<NamedStreamMapping> NamedStreams; |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 57 | }; |
| 58 | |
| Zachary Turner | 3b14764 | 2016-10-08 01:12:01 +0000 | [diff] [blame] | 59 | struct PdbSymbolRecord { |
| 60 | codeview::CVSymbol Record; |
| 61 | }; |
| 62 | |
| 63 | struct PdbModiStream { |
| 64 | uint32_t Signature; |
| 65 | std::vector<PdbSymbolRecord> Symbols; |
| 66 | }; |
| 67 | |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 68 | struct PdbSourceLineEntry { |
| 69 | uint32_t Offset; |
| 70 | uint32_t LineStart; |
| 71 | uint32_t EndDelta; |
| 72 | bool IsStatement; |
| 73 | }; |
| 74 | |
| 75 | struct PdbSourceColumnEntry { |
| 76 | uint16_t StartColumn; |
| 77 | uint16_t EndColumn; |
| 78 | }; |
| 79 | |
| 80 | struct PdbSourceLineBlock { |
| 81 | StringRef FileName; |
| 82 | std::vector<PdbSourceLineEntry> Lines; |
| 83 | std::vector<PdbSourceColumnEntry> Columns; |
| 84 | }; |
| 85 | |
| 86 | struct HexFormattedString { |
| 87 | std::vector<uint8_t> Bytes; |
| 88 | }; |
| 89 | |
| 90 | struct PdbSourceFileChecksumEntry { |
| 91 | StringRef FileName; |
| 92 | codeview::FileChecksumKind Kind; |
| 93 | HexFormattedString ChecksumBytes; |
| 94 | }; |
| 95 | |
| 96 | struct PdbSourceLineInfo { |
| 97 | uint32_t RelocOffset; |
| 98 | uint32_t RelocSegment; |
| 99 | codeview::LineFlags Flags; |
| 100 | uint32_t CodeSize; |
| 101 | |
| Zachary Turner | 5b6e4e0 | 2017-04-29 01:13:21 +0000 | [diff] [blame] | 102 | std::vector<PdbSourceLineBlock> Blocks; |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 103 | }; |
| 104 | |
| Zachary Turner | edef145 | 2017-05-02 16:56:09 +0000 | [diff] [blame^] | 105 | struct PdbInlineeSite { |
| 106 | codeview::TypeIndex Inlinee; |
| 107 | StringRef FileName; |
| 108 | uint32_t SourceLineNum; |
| 109 | std::vector<StringRef> ExtraFiles; |
| 110 | }; |
| 111 | |
| 112 | struct PdbInlineeInfo { |
| 113 | bool HasExtraFiles; |
| 114 | std::vector<PdbInlineeSite> Sites; |
| 115 | }; |
| 116 | |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 117 | struct PdbSourceFileInfo { |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 118 | std::vector<PdbSourceFileChecksumEntry> FileChecksums; |
| Zachary Turner | 5b6e4e0 | 2017-04-29 01:13:21 +0000 | [diff] [blame] | 119 | std::vector<PdbSourceLineInfo> LineFragments; |
| Zachary Turner | edef145 | 2017-05-02 16:56:09 +0000 | [diff] [blame^] | 120 | std::vector<PdbInlineeInfo> Inlinees; |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 121 | }; |
| 122 | |
| Zachary Turner | d218c26 | 2016-07-22 15:46:37 +0000 | [diff] [blame] | 123 | struct PdbDbiModuleInfo { |
| 124 | StringRef Obj; |
| 125 | StringRef Mod; |
| 126 | std::vector<StringRef> SourceFiles; |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 127 | Optional<PdbSourceFileInfo> FileLineInfo; |
| Zachary Turner | 3b14764 | 2016-10-08 01:12:01 +0000 | [diff] [blame] | 128 | Optional<PdbModiStream> Modi; |
| Zachary Turner | d218c26 | 2016-07-22 15:46:37 +0000 | [diff] [blame] | 129 | }; |
| 130 | |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 131 | struct PdbDbiStream { |
| Zachary Turner | ea4e607 | 2017-03-15 22:18:53 +0000 | [diff] [blame] | 132 | PdbRaw_DbiVer VerHeader = PdbDbiV70; |
| 133 | uint32_t Age = 1; |
| 134 | uint16_t BuildNumber = 0; |
| 135 | uint32_t PdbDllVersion = 0; |
| 136 | uint16_t PdbDllRbld = 0; |
| 137 | uint16_t Flags = 1; |
| 138 | PDB_Machine MachineType = PDB_Machine::x86; |
| Zachary Turner | d218c26 | 2016-07-22 15:46:37 +0000 | [diff] [blame] | 139 | |
| 140 | std::vector<PdbDbiModuleInfo> ModInfos; |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 141 | }; |
| 142 | |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 143 | struct PdbTpiRecord { |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 144 | codeview::CVType Record; |
| 145 | }; |
| 146 | |
| Zachary Turner | c67b00c | 2016-09-14 23:00:16 +0000 | [diff] [blame] | 147 | struct PdbTpiFieldListRecord { |
| 148 | codeview::CVMemberRecord Record; |
| 149 | }; |
| 150 | |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 151 | struct PdbTpiStream { |
| Zachary Turner | ea4e607 | 2017-03-15 22:18:53 +0000 | [diff] [blame] | 152 | PdbRaw_TpiVer Version = PdbTpiV80; |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 153 | std::vector<PdbTpiRecord> Records; |
| 154 | }; |
| 155 | |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 156 | struct PdbObject { |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 157 | explicit PdbObject(BumpPtrAllocator &Allocator) : Allocator(Allocator) {} |
| 158 | |
| Zachary Turner | a3225b0 | 2016-07-29 20:56:36 +0000 | [diff] [blame] | 159 | Optional<MSFHeaders> Headers; |
| Zachary Turner | faa554b | 2016-07-15 22:16:56 +0000 | [diff] [blame] | 160 | Optional<std::vector<uint32_t>> StreamSizes; |
| Zachary Turner | 1dc9fd3 | 2016-06-14 20:48:36 +0000 | [diff] [blame] | 161 | Optional<std::vector<StreamBlockList>> StreamMap; |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 162 | Optional<PdbInfoStream> PdbStream; |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 163 | Optional<PdbDbiStream> DbiStream; |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 164 | Optional<PdbTpiStream> TpiStream; |
| Zachary Turner | de9ba15 | 2016-09-15 18:22:31 +0000 | [diff] [blame] | 165 | Optional<PdbTpiStream> IpiStream; |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 166 | |
| Zachary Turner | 760ad4d | 2017-01-20 22:42:09 +0000 | [diff] [blame] | 167 | Optional<std::vector<StringRef>> StringTable; |
| 168 | |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 169 | BumpPtrAllocator &Allocator; |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 170 | }; |
| 171 | } |
| 172 | } |
| Zachary Turner | 25e8b05 | 2016-06-06 20:37:17 +0000 | [diff] [blame] | 173 | } |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 174 | |
| Zachary Turner | 25e8b05 | 2016-06-06 20:37:17 +0000 | [diff] [blame] | 175 | namespace llvm { |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 176 | namespace yaml { |
| Zachary Turner | 1dc9fd3 | 2016-06-14 20:48:36 +0000 | [diff] [blame] | 177 | |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 178 | template <> struct MappingTraits<pdb::yaml::PdbObject> { |
| 179 | static void mapping(IO &IO, pdb::yaml::PdbObject &Obj); |
| 180 | }; |
| 181 | |
| Zachary Turner | a3225b0 | 2016-07-29 20:56:36 +0000 | [diff] [blame] | 182 | template <> struct MappingTraits<pdb::yaml::MSFHeaders> { |
| 183 | static void mapping(IO &IO, pdb::yaml::MSFHeaders &Obj); |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 184 | }; |
| 185 | |
| Zachary Turner | bac69d3 | 2016-07-22 19:56:05 +0000 | [diff] [blame] | 186 | template <> struct MappingTraits<msf::SuperBlock> { |
| 187 | static void mapping(IO &IO, msf::SuperBlock &SB); |
| Zachary Turner | 25e8b05 | 2016-06-06 20:37:17 +0000 | [diff] [blame] | 188 | }; |
| 189 | |
| Zachary Turner | 1dc9fd3 | 2016-06-14 20:48:36 +0000 | [diff] [blame] | 190 | template <> struct MappingTraits<pdb::yaml::StreamBlockList> { |
| 191 | static void mapping(IO &IO, pdb::yaml::StreamBlockList &SB); |
| Zachary Turner | 25e8b05 | 2016-06-06 20:37:17 +0000 | [diff] [blame] | 192 | }; |
| 193 | |
| Zachary Turner | 8848a7a | 2016-07-06 18:05:57 +0000 | [diff] [blame] | 194 | template <> struct MappingTraits<pdb::yaml::PdbInfoStream> { |
| 195 | static void mapping(IO &IO, pdb::yaml::PdbInfoStream &Obj); |
| 196 | }; |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 197 | |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 198 | template <> struct MappingContextTraits<pdb::yaml::PdbDbiStream, pdb::yaml::SerializationContext> { |
| 199 | static void mapping(IO &IO, pdb::yaml::PdbDbiStream &Obj, pdb::yaml::SerializationContext &Context); |
| Zachary Turner | dbeaea7 | 2016-07-11 21:45:26 +0000 | [diff] [blame] | 200 | }; |
| Zachary Turner | 5e534c7 | 2016-07-15 22:17:08 +0000 | [diff] [blame] | 201 | |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 202 | template <> |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 203 | struct MappingContextTraits<pdb::yaml::PdbTpiStream, pdb::yaml::SerializationContext> { |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 204 | static void mapping(IO &IO, pdb::yaml::PdbTpiStream &Obj, |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 205 | pdb::yaml::SerializationContext &Context); |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 206 | }; |
| 207 | |
| Zachary Turner | 5e534c7 | 2016-07-15 22:17:08 +0000 | [diff] [blame] | 208 | template <> struct MappingTraits<pdb::yaml::NamedStreamMapping> { |
| 209 | static void mapping(IO &IO, pdb::yaml::NamedStreamMapping &Obj); |
| 210 | }; |
| Zachary Turner | d218c26 | 2016-07-22 15:46:37 +0000 | [diff] [blame] | 211 | |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 212 | template <> struct MappingContextTraits<pdb::yaml::PdbSymbolRecord, pdb::yaml::SerializationContext> { |
| 213 | static void mapping(IO &IO, pdb::yaml::PdbSymbolRecord &Obj, pdb::yaml::SerializationContext &Context); |
| Zachary Turner | 3b14764 | 2016-10-08 01:12:01 +0000 | [diff] [blame] | 214 | }; |
| 215 | |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 216 | template <> struct MappingContextTraits<pdb::yaml::PdbModiStream, pdb::yaml::SerializationContext> { |
| 217 | static void mapping(IO &IO, pdb::yaml::PdbModiStream &Obj, pdb::yaml::SerializationContext &Context); |
| Zachary Turner | 3b14764 | 2016-10-08 01:12:01 +0000 | [diff] [blame] | 218 | }; |
| 219 | |
| Zachary Turner | 407dec5 | 2017-03-13 14:57:45 +0000 | [diff] [blame] | 220 | template <> struct MappingContextTraits<pdb::yaml::PdbDbiModuleInfo, pdb::yaml::SerializationContext> { |
| 221 | static void mapping(IO &IO, pdb::yaml::PdbDbiModuleInfo &Obj, pdb::yaml::SerializationContext &Context); |
| Zachary Turner | d218c26 | 2016-07-22 15:46:37 +0000 | [diff] [blame] | 222 | }; |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 223 | |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 224 | template <> |
| Zachary Turner | ee3b9c2 | 2017-04-25 20:22:02 +0000 | [diff] [blame] | 225 | struct MappingContextTraits<pdb::yaml::PdbSourceLineEntry, |
| 226 | pdb::yaml::SerializationContext> { |
| 227 | static void mapping(IO &IO, pdb::yaml::PdbSourceLineEntry &Obj, |
| 228 | pdb::yaml::SerializationContext &Context); |
| 229 | }; |
| 230 | |
| 231 | template <> |
| 232 | struct MappingContextTraits<pdb::yaml::PdbSourceColumnEntry, |
| 233 | pdb::yaml::SerializationContext> { |
| 234 | static void mapping(IO &IO, pdb::yaml::PdbSourceColumnEntry &Obj, |
| 235 | pdb::yaml::SerializationContext &Context); |
| 236 | }; |
| 237 | |
| 238 | template <> |
| 239 | struct MappingContextTraits<pdb::yaml::PdbSourceLineBlock, |
| 240 | pdb::yaml::SerializationContext> { |
| 241 | static void mapping(IO &IO, pdb::yaml::PdbSourceLineBlock &Obj, |
| 242 | pdb::yaml::SerializationContext &Context); |
| 243 | }; |
| 244 | |
| 245 | template <> |
| 246 | struct MappingContextTraits<pdb::yaml::PdbSourceFileChecksumEntry, |
| 247 | pdb::yaml::SerializationContext> { |
| 248 | static void mapping(IO &IO, pdb::yaml::PdbSourceFileChecksumEntry &Obj, |
| 249 | pdb::yaml::SerializationContext &Context); |
| 250 | }; |
| 251 | |
| 252 | template <> struct ScalarTraits<pdb::yaml::HexFormattedString> { |
| 253 | static void output(const pdb::yaml::HexFormattedString &Value, void *ctx, |
| 254 | llvm::raw_ostream &Out); |
| 255 | static StringRef input(StringRef Scalar, void *ctxt, |
| 256 | pdb::yaml::HexFormattedString &Value); |
| 257 | static bool mustQuote(StringRef) { return false; } |
| 258 | }; |
| 259 | |
| 260 | template <> |
| 261 | struct MappingContextTraits<pdb::yaml::PdbSourceLineInfo, |
| 262 | pdb::yaml::SerializationContext> { |
| 263 | static void mapping(IO &IO, pdb::yaml::PdbSourceLineInfo &Obj, |
| 264 | pdb::yaml::SerializationContext &Context); |
| 265 | }; |
| 266 | |
| 267 | template <> |
| 268 | struct MappingContextTraits<pdb::yaml::PdbSourceFileInfo, |
| 269 | pdb::yaml::SerializationContext> { |
| 270 | static void mapping(IO &IO, pdb::yaml::PdbSourceFileInfo &Obj, |
| 271 | pdb::yaml::SerializationContext &Context); |
| 272 | }; |
| 273 | |
| 274 | template <> |
| Zachary Turner | edef145 | 2017-05-02 16:56:09 +0000 | [diff] [blame^] | 275 | struct MappingContextTraits<pdb::yaml::PdbInlineeInfo, |
| 276 | pdb::yaml::SerializationContext> { |
| 277 | static void mapping(IO &IO, pdb::yaml::PdbInlineeInfo &Obj, |
| 278 | pdb::yaml::SerializationContext &Context); |
| 279 | }; |
| 280 | |
| 281 | template <> |
| 282 | struct MappingContextTraits<pdb::yaml::PdbInlineeSite, |
| 283 | pdb::yaml::SerializationContext> { |
| 284 | static void mapping(IO &IO, pdb::yaml::PdbInlineeSite &Obj, |
| 285 | pdb::yaml::SerializationContext &Context); |
| 286 | }; |
| 287 | |
| 288 | template <> |
| Zachary Turner | c6d54da | 2016-09-09 17:46:17 +0000 | [diff] [blame] | 289 | struct MappingContextTraits<pdb::yaml::PdbTpiRecord, |
| 290 | pdb::yaml::SerializationContext> { |
| 291 | static void mapping(IO &IO, pdb::yaml::PdbTpiRecord &Obj, |
| 292 | pdb::yaml::SerializationContext &Context); |
| Zachary Turner | ac5763e | 2016-08-18 16:49:29 +0000 | [diff] [blame] | 293 | }; |
| 294 | } |
| 295 | } |
| Zachary Turner | 7120a47 | 2016-06-06 20:37:05 +0000 | [diff] [blame] | 296 | |
| 297 | #endif // LLVM_TOOLS_LLVMPDBDUMP_PDBYAML_H |