Lưu ý
Mục đích của file này là để độc giả tiếng Việt có thể đọc và hiểu tài liệu nhân kernel dễ dàng hơn, không phải để tạo ra một nhánh tài liệu riêng. Nếu bạn có bất kỳ nhận xét hoặc cập nhật nào cho file này, vui lòng thử cập nhật file tiếng Anh gốc trước. Nếu bạn thấy có sự khác biệt giữa bản dịch và bản gốc, hoặc có vấn đề về bản dịch, vui lòng gửi góp ý hoặc patch cho người dịch của file này, hoặc nhờ người bảo trì và người review tài liệu tiếng Việt giúp đỡ.
- Bản gốc:
- Người dịch:
Google Translate (machine translation)
- Phiên bản gốc:
8541d8f725c6
Cảnh báo
Tài liệu này được dịch tự động bằng máy và chưa được review bởi người dịch. Nội dung có thể không chính xác hoặc khó hiểu ở một số chỗ. Khi có sự khác biệt với bản gốc, bản gốc luôn là chuẩn. Bản dịch chất lượng cao (được review) được đặt trong thư mục vi_VN/.
Lớp trình phân tích tài liệu Kernel ABI¶
Parse ABI documentation and produce results from it.
- class lib.python.abi.abi_parser.AbiParser(directory, logger=None, enable_lineno=False, show_warnings=True, debug=0)¶
Bases:
objectMain class to parse ABI files.
- TAGS = '(what|where|date|kernelversion|contact|description|users)'¶
Valid tags at Documentation/ABI.
- XREF = '(?:^|\\s|\\()(\\/(?:sys|config|proc|dev|kvd)\\/[^,.:;\\)\\s]+)(?:[,.:;\\)\\s]|\\Z)'¶
ABI elements that will auto-generate cross-references.
- add_symbol(what, fname, ln=None, xref=None)¶
Create a reference table describing where each ‘what’ is located.
- check_issues()¶
Warn about duplicated ABI entries.
- desc_rst(desc)¶
Enrich ReST output by creating cross-references.
- desc_txt(desc)¶
Print description as found inside ABI files.
- doc(output_in_txt=False, show_symbols=True, show_file=True, filter_path=None)¶
Print ABI at stdout.
- parse_abi(root=None)¶
Parse documentation ABI.
- parse_file(fname, path, basename)¶
Parse a single file.
- parse_readme(nametag, fname)¶
Parse ABI README file.
- search_symbols(expr)¶
Searches for ABI symbols.
- warn(fdata, msg, extra=None)¶
Displays a parse error if warning is enabled.
- xref(fname)¶
Converts a Documentation/ABI + basename into a ReST cross-reference.