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/.
Giao diện Netlink cho ethtool¶
Thông tin cơ bản¶
Giao diện Netlink cho ethtool sử dụng họ netlink chung ZZ0000ZZ (ứng dụng không gian người dùng nên sử dụng macro ZZ0001ZZ và ZZ0002ZZ được định nghĩa trong uapi ZZ0003ZZ tiêu đề). Họ này không sử dụng một tiêu đề cụ thể, tất cả thông tin trong yêu cầu và trả lời được chuyển bằng thuộc tính netlink.
Giao diện netlink ethtool sử dụng ACK mở rộng để phát hiện lỗi và cảnh báo báo cáo, các nhà phát triển ứng dụng không gian người dùng được khuyến khích thực hiện những điều này thông điệp có sẵn cho người dùng một cách phù hợp.
Yêu cầu có thể được chia thành ba loại: “get” (lấy thông tin), “set” (cài đặt tham số) và “hành động” (gọi một hành động).
Tất cả các yêu cầu loại “đặt” và “hành động” đều yêu cầu quyền quản trị viên (ZZ0000ZZ trong không gian tên). Hầu hết các yêu cầu loại “nhận” đều được phép bất kỳ ai ngoại trừ những trường hợp ngoại lệ (trong đó phản hồi có chứa thông tin nhạy cảm thông tin). Trong một số trường hợp, yêu cầu như vậy được phép đối với bất kỳ ai ngoại trừ người dùng không có đặc quyền có các thuộc tính có thông tin nhạy cảm (ví dụ: mật khẩu Wake-on-lan) bị bỏ qua.
Công ước¶
Các thuộc tính đại diện cho giá trị boolean thường sử dụng loại NLA_U8 để chúng ta có thể phân biệt ba trạng thái: “bật”, “tắt” và “không hiện diện” (nghĩa là thông tin không có sẵn trong yêu cầu “nhận” hoặc giá trị không thể thay đổi trong các yêu cầu “đặt”). Đối với các thuộc tính này, giá trị “true” phải được chuyển dưới dạng số 1 nhưng mọi giá trị khác 0 sẽ được người nhận hiểu là “true”. Trong các bảng bên dưới, “bool” biểu thị các thuộc tính NLA_U8 được diễn giải theo cách này.
Trong mô tả cấu trúc thông báo bên dưới, nếu tên thuộc tính được thêm vào với “+”, tổ mẹ có thể chứa nhiều thuộc tính cùng loại. Cái này thực hiện một loạt các mục.
Các thuộc tính cần được trình điều khiển thiết bị điền vào và được chuyển vào không gian người dùng dựa trên việc chúng có hợp lệ hay không không nên sử dụng số 0 làm giá trị hợp lệ. Điều này tránh sự cần thiết phải báo hiệu rõ ràng tính hợp lệ của thuộc tính trong trình điều khiển thiết bị API.
Tiêu đề yêu cầu¶
Mỗi tin nhắn yêu cầu hoặc trả lời chứa một thuộc tính lồng nhau với tiêu đề chung. Cấu trúc của tiêu đề này là
Đối với các bitmap ngắn có độ dài cố định (hợp lý), ZZ0000ZZ tiêu chuẩn loại được sử dụng. Đối với các bitmap có độ dài tùy ý, ethtool netlink sử dụng một thuộc tính có nội dung thuộc một trong hai dạng: nhỏ gọn (hai bitmap nhị phân đại diện cho các giá trị bit và mặt nạ của các bit bị ảnh hưởng) và từng bit (danh sách bit được xác định theo chỉ mục hoặc tên).
Các bit dài dòng (từng bit) cho phép gửi tên tượng trưng cho các bit cùng nhau với các giá trị của chúng giúp tiết kiệm một chuyến đi khứ hồi (khi bitset được truyền trong một yêu cầu) hoặc ít nhất là yêu cầu thứ hai (khi bitset trả lời). Đây là hữu ích cho các ứng dụng một lần như lệnh ethtool truyền thống. Trên mặt khác, các ứng dụng chạy dài như màn hình ethtool (hiển thị thông báo) hoặc trình nền quản lý mạng có thể thích tìm nạp tên chỉ một lần và sử dụng hình thức thu gọn để tiết kiệm kích thước tin nhắn. Thông báo từ Giao diện netlink ethtool luôn sử dụng dạng nhỏ gọn cho các bit.
Một bitset có thể đại diện cho một cặp giá trị/mặt nạ (ZZ0000ZZ chưa được đặt) hoặc một bitmap đơn (bộ ZZ0001ZZ). Trong yêu cầu sửa đổi một bitmap, cái trước sẽ thay đổi bit được đặt trong mặt nạ thành các giá trị được đặt trong giá trị và bảo tồn phần còn lại; cái sau đặt các bit được đặt trong bitmap và xóa phần còn lại.
Dạng thu gọn: nội dung thuộc tính lồng nhau (bitset):
Tất cả các hằng số xác định loại thông báo đều sử dụng tiền tố và hậu tố ZZ0000ZZ theo mục đích tin nhắn:
Yêu cầu không gian người dùng ZZ0002ZZ để thực hiện một hành động Hạt nhân ZZ0003ZZ trả lời yêu cầu ZZ0004ZZ Hạt nhân ZZ0005ZZ trả lời yêu cầu ZZ0006ZZ Hạt nhân ZZ0007ZZ trả lời yêu cầu ZZ0008ZZ Thông báo hạt nhân ZZ0009ZZ ========================================================
Không gian người dùng cho kernel:
ZZ0002ZZ thiết lập cài đặt liên kết ZZ0003ZZ lấy thông tin chế độ liên kết ZZ0004ZZ thiết lập thông tin chế độ liên kết ZZ0005ZZ nhận trạng thái liên kết ZZ0006ZZ nhận cài đặt gỡ lỗi ZZ0007ZZ đặt cài đặt gỡ lỗi ZZ0008ZZ nhận cài đặt đánh thức trên mạng ZZ0009ZZ đặt cài đặt đánh thức trên mạng ZZ0010ZZ nhận các tính năng của thiết bị ZZ0011ZZ cài đặt tính năng của thiết bị ZZ0012ZZ nhận cờ riêng ZZ0013ZZ đặt cờ riêng ZZ0014ZZ nhận kích thước nhẫn ZZ0015ZZ đặt kích thước vòng ZZ0016ZZ lấy số lượng kênh ZZ0017ZZ đặt số lượng kênh ZZ0018ZZ lấy thông số kết hợp ZZ0019ZZ đặt tham số kết hợp ZZ0020ZZ nhận thông số tạm dừng ZZ0021ZZ đặt thông số tạm dừng ZZ0022ZZ nhận cài đặt EEE ZZ0023ZZ đặt cài đặt EEE ZZ0024ZZ lấy thông tin về dấu thời gian Kiểm tra cáp khởi động hành động ZZ0025ZZ Hành động ZZ0026ZZ bắt đầu thử nghiệm cáp TDR thô ZZ0027ZZ lấy thông tin giảm tải đường hầm ZZ0028ZZ nhận cài đặt FEC ZZ0029ZZ đặt cài đặt FEC ZZ0030ZZ đọc mô-đun SFP EEPROM ZZ0031ZZ lấy số liệu thống kê tiêu chuẩn ZZ0032ZZ lấy thông tin đồng hồ ảo PHC ZZ0033ZZ đặt thông số mô-đun thu phát ZZ0034ZZ lấy thông số mô-đun thu phát ZZ0035ZZ cài đặt thông số PSE ZZ0036ZZ lấy thông số PSE ZZ0037ZZ nhận cài đặt RSS ZZ0038ZZ lấy thông số PLCA RS ZZ0039ZZ đặt thông số PLCA RS ZZ0040ZZ nhận trạng thái PLCA RS ZZ0041ZZ nhận trạng thái lớp hợp nhất MAC ZZ0042ZZ đặt tham số lớp hợp nhất MAC Phần mềm mô-đun thu phát flash ZZ0043ZZ Thông tin ZZ0044ZZ nhận Ethernet PHY ZZ0045ZZ nhận cấu hình đánh dấu thời gian ZZ0046ZZ đặt cấu hình đánh dấu thời gian hw ZZ0047ZZ đặt cài đặt RSS ZZ0048ZZ tạo bối cảnh RSS bổ sung ZZ0049ZZ xóa bối cảnh RSS bổ sung ZZ0050ZZ lấy dữ liệu chẩn đoán MSE ============================================================================
Hạt nhân tới không gian người dùng:
Thông báo cài đặt liên kết ZZ0002ZZ Thông tin chế độ liên kết ZZ0003ZZ Thông báo chế độ liên kết ZZ0004ZZ Thông tin trạng thái liên kết ZZ0005ZZ Cài đặt gỡ lỗi ZZ0006ZZ Thông báo cài đặt gỡ lỗi ZZ0007ZZ Cài đặt đánh thức ZZ0008ZZ Thông báo cài đặt Wake-on-lan ZZ0009ZZ Tính năng của thiết bị ZZ0010ZZ ZZ0011ZZ trả lời tùy chọn cho FEATURES_SET Thông báo tính năng của netdev ZZ0012ZZ Cờ riêng ZZ0013ZZ Cờ riêng ZZ0014ZZ Kích thước vòng ZZ0015ZZ Kích thước vòng ZZ0016ZZ Số kênh ZZ0017ZZ Số kênh ZZ0018ZZ Thông số kết hợp ZZ0019ZZ Thông số kết hợp ZZ0020ZZ Thông số tạm dừng ZZ0021ZZ Thông số tạm dừng ZZ0022ZZ Cài đặt ZZ0023ZZ EEE Cài đặt ZZ0024ZZ EEE Thông tin về dấu thời gian của ZZ0025ZZ Kết quả kiểm tra cáp ZZ0026ZZ ZZ0027ZZ Kiểm tra cáp Kết quả TDR Thông tin giảm tải đường hầm ZZ0028ZZ Cài đặt ZZ0029ZZ FEC Cài đặt ZZ0030ZZ FEC ZZ0031ZZ đọc mô-đun SFP EEPROM Thống kê tiêu chuẩn ZZ0032ZZ Thông tin đồng hồ ảo ZZ0033ZZ PHC Thông số mô-đun thu phát ZZ0034ZZ Thông số ZZ0035ZZ PSE Cài đặt ZZ0036ZZ RSS Cài đặt ZZ0037ZZ RSS Thông số ZZ0038ZZ PLCA RS Trạng thái ZZ0039ZZ PLCA RS Thông số ZZ0040ZZ PLCA RS Trạng thái lớp hợp nhất ZZ0041ZZ MAC Cập nhật flash mô-đun thu phát ZZ0042ZZ Thông tin ZZ0043ZZ Ethernet PHY ZZ0044ZZ Ethernet PHY thay đổi thông tin Cấu hình đánh dấu thời gian ZZ0045ZZ hw ZZ0046ZZ cấu hình đánh dấu thời gian hw mới Thông báo sự kiện ZZ0047ZZ PSE Thông báo cài đặt ZZ0048ZZ RSS ZZ0049ZZ tạo bối cảnh RSS bổ sung Đã tạo bối cảnh RSS bổ sung ZZ0050ZZ Đã xóa bối cảnh RSS bổ sung ZZ0051ZZ Dữ liệu chẩn đoán ZZ0052ZZ MSE ==============================================================================
Yêu cầu ZZ0000ZZ được gửi bởi ứng dụng không gian người dùng để truy xuất thiết bị thông tin. Chúng thường không chứa bất kỳ thuộc tính cụ thể nào của tin nhắn. Kernel trả lời bằng thông báo “GET_REPLY” tương ứng. Đối với hầu hết các loại, ZZ0001ZZ yêu cầu với ZZ0002ZZ và không thể sử dụng nhận dạng thiết bị để truy vấn thông tin cho tất cả các thiết bị hỗ trợ yêu cầu.
Nếu dữ liệu cũng có thể được sửa đổi, thông báo ZZ0000ZZ tương ứng có cùng nội dung bố cục như ZZ0001ZZ tương ứng được sử dụng để yêu cầu thay đổi. Chỉ các thuộc tính nơi yêu cầu thay đổi được bao gồm trong yêu cầu đó (đồng thời, không phải tất cả các thuộc tính có thể được thay đổi). Các câu trả lời cho hầu hết yêu cầu ZZ0002ZZ chỉ bao gồm mã lỗi và exack; nếu kernel cung cấp dữ liệu bổ sung, nó sẽ được gửi vào dạng thông báo ZZ0003ZZ tương ứng có thể bị chặn bởi cài đặt cờ ZZ0004ZZ trong tiêu đề yêu cầu.
Việc sửa đổi dữ liệu cũng kích hoạt việc gửi tin nhắn ZZ0000ZZ kèm theo thông báo. Chúng thường chỉ mang một tập hợp con các thuộc tính bị ảnh hưởng bởi thay đổi. Thông báo tương tự được đưa ra nếu dữ liệu được sửa đổi bằng cách sử dụng khác có nghĩa là (chủ yếu là giao diện ioctl ethtool). Không giống như thông báo từ ethtool mã netlink chỉ được gửi nếu có gì đó thực sự thay đổi, thông báo được kích hoạt bởi giao diện ioctl có thể được gửi ngay cả khi yêu cầu không thực sự thay đổi bất kỳ dữ liệu nào
Tin nhắn ZZ0000ZZ yêu cầu kernel (trình điều khiển) thực hiện một hành động cụ thể. Nếu một số thông tin được báo cáo bởi kernel (có thể bị chặn bằng cách cài đặt Cờ ZZ0001ZZ trong tiêu đề yêu cầu), câu trả lời có dạng một tin nhắn ZZ0002ZZ. Thực hiện một hành động cũng kích hoạt thông báo (Tin nhắn ZZ0003ZZ).
Các phần sau mô tả định dạng và ngữ nghĩa của các thông báo này.
STRSET_GET¶
Yêu cầu nội dung của một chuỗi được cung cấp bởi các lệnh ioctl Bộ chuỗi ZZ0000ZZ và ZZ0001ZZ không phải là người dùng có thể ghi nên thông báo ZZ0002ZZ tương ứng chỉ được sử dụng trong câu trả lời của hạt nhân. Có hai loại bộ chuỗi: toàn cục (độc lập với một thiết bị, ví dụ: tên tính năng của thiết bị) và thiết bị cụ thể (ví dụ: thiết bị riêng tư cờ).
Nội dung yêu cầu:
ZZ0004ZZ lồng nhau ZZ0005ZZ +---------------------------------------+--------+---------------+ ZZ0006ZZ lồng nhau ZZ0007ZZ +-+---------------------------------------------------+--------+--------------+ ZZ0008ZZ ZZ0002ZZ ZZ0009ZZ bộ một dây | +-+-+-----------------------------------+--------+--------------+ ZZ0010ZZ ZZ0011ZZ u32 ZZ0012ZZ +-+-+-----------------------------------+--------+--------------+
Nội dung phản hồi hạt nhân:
ZZ0010ZZ lồng nhau ZZ0011ZZ +---------------------------------------+--------+--------------+ ZZ0012ZZ lồng nhau ZZ0013ZZ +-+---------------------------------------------------+--------+--------------+ ZZ0014ZZ ZZ0002ZZ ZZ0015ZZ bộ một dây | +-+-+-----------------------------------+--------+--------------+ ZZ0016ZZ ZZ0017ZZ u32 ZZ0018ZZ +-+-+-----------------------------------+--------+--------------+ ZZ0019ZZ ZZ0020ZZ u32 ZZ0021ZZ +-+-+-----------------------------------+--------+--------------+ ZZ0022ZZ ZZ0023ZZ lồng nhau ZZ0024ZZ +-+-+-+---------------------------------+--------+--------------+ ZZ0025ZZ ZZ0026ZZ ZZ0006ZZ ZZ0027ZZ một chuỗi | +-+-+-+-+----------------------+--------+--------------+ ZZ0028ZZ ZZ0029ZZ ZZ0030ZZ u32 ZZ0031ZZ +-+-+-+-+----------------------+--------+--------------+ ZZ0032ZZ ZZ0033ZZ ZZ0034ZZ chuỗi ZZ0035ZZ +-+-+-+-+----------------------+--------+--------------+ Cờ ZZ0036ZZ ZZ0037ZZ +---------------------------------------+--------+--------------+
Nhận dạng thiết bị trong tiêu đề yêu cầu là tùy chọn. Tùy thuộc vào sự hiện diện của nó a và cờ ZZ0000ZZ, có ba loại yêu cầu ZZ0001ZZ:
không có ZZ0000ZZ không có thiết bị: nhận các bộ chuỗi “toàn cầu”
không có ZZ0001ZZ, có thiết bị: lấy các bộ chuỗi liên quan đến thiết bị
ZZ0002ZZ, không có thiết bị: nhận bộ chuỗi liên quan đến thiết bị cho tất cả các thiết bị
Nếu không có mảng ZZ0000ZZ, tất cả các bộ chuỗi loại được yêu cầu sẽ được trả về, nếu không thì chỉ những loại được chỉ định trong yêu cầu. Cờ ZZ0001ZZ yêu cầu kernel chỉ trả về chuỗi số lượng bộ chứ không phải số chuỗi thực tế.
LINKINFO_GET¶
Yêu cầu cài đặt liên kết do ZZ0000ZZ cung cấp ngoại trừ chế độ liên kết và thông tin liên quan đến tự động đàm phán. Yêu cầu không sử dụng bất kỳ thuộc tính nào.
Nội dung yêu cầu:
Yêu cầu ZZ0000ZZ cho phép thiết lập một số thuộc tính được báo cáo bởi ZZ0001ZZ.
Nội dung yêu cầu:
Yêu cầu các chế độ liên kết (được hỗ trợ, quảng cáo và quảng cáo ngang hàng) và các chế độ liên quan thông tin (trạng thái tự động đàm phán, tốc độ liên kết và song công) được cung cấp bởi ZZ0000ZZ. Yêu cầu không sử dụng bất kỳ thuộc tính nào.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Trạng thái tự động đàm phán ZZ0001ZZ u8 Chế độ liên kết được quảng cáo bitset ZZ0002ZZ Chế độ liên kết đối tác bitset ZZ0003ZZ Tốc độ liên kết ZZ0004ZZ u32 (Mb/s) Chế độ song công ZZ0005ZZ u8 ZZ0006ZZ u8 Chế độ cổng chính/phụ ZZ0007ZZ u8 Trạng thái cổng chính/phụ Khớp tỷ lệ ZZ0008ZZ u8 PHY ============================================ ====== =============================
Đối với ZZ0000ZZ, giá trị đại diện cho các chế độ và mặt nạ được quảng cáo đại diện cho các chế độ được hỗ trợ. ZZ0001ZZ ở phần trả lời có hơi chút danh sách.
ZZ0000ZZ cho phép kết xuất các yêu cầu (kernel trả về tin nhắn trả lời cho tất cả thiết bị hỗ trợ yêu cầu).
LINKMODES_SET¶
Nội dung yêu cầu:
Yêu cầu thông tin trạng thái liên kết. Cờ liên kết lên/xuống (được cung cấp bởi Lệnh ZZ0000ZZ ioctl) được cung cấp. Tùy chọn, trạng thái mở rộng có thể cũng được cung cấp. Nói chung, trạng thái mở rộng mô tả lý do tại sao một cổng không hoạt động hoặc tại sao nó hoạt động ở một chế độ không rõ ràng. Yêu cầu này không có bất kỳ thuộc tính nào.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Trạng thái liên kết bool ZZ0001ZZ (lên/xuống) ZZ0002ZZ u32 Chỉ số chất lượng tín hiệu hiện tại ZZ0003ZZ u32 Hỗ trợ tối đa giá trị SQI Trạng thái mở rộng liên kết ZZ0004ZZ u8 Trạm biến áp mở rộng liên kết ZZ0005ZZ u8 ZZ0006ZZ u32 số sự kiện liên kết xuống =========================================== ===============================
Đối với hầu hết các trình điều khiển NIC, giá trị của ZZ0000ZZ trả về cờ nhà mạng do ZZ0001ZZ cung cấp nhưng có trình điều khiển xác định trình xử lý riêng của họ.
ZZ0000ZZ và ZZ0001ZZ là các giá trị tùy chọn. lõi ethtool có thể cung cấp cả hai ZZ0002ZZ và ZZ0003ZZ, hoặc chỉ ZZ0004ZZ, hoặc không có cái nào trong số đó.
ZZ0000ZZ cho phép kết xuất các yêu cầu (kernel trả về tin nhắn trả lời cho tất cả thiết bị hỗ trợ yêu cầu).
Liên kết các trạng thái mở rộng:
ZZ0000ZZ Lỗi trong quá trình đào tạo liên kết
- ZZ0000ZZ Sự không khớp logic trong lớp con mã hóa vật lý
hoặc chuyển tiếp lớp con sửa lỗi
Vấn đề về tính toàn vẹn tín hiệu ZZ0000ZZ
ZZ0000ZZ Không có cáp kết nối
- ZZ0000ZZ Lỗi liên quan đến cáp,
ví dụ: cáp không được hỗ trợ
- Lỗi ZZ0000ZZ có liên quan đến EEPROM, ví dụ: lỗi
trong khi đọc hoặc phân tích dữ liệu
ZZ0000ZZ Lỗi trong thuật toán hiệu chuẩn
- ZZ0000ZZ Phần cứng không thể cung cấp
nguồn điện cần thiết từ cáp hoặc mô-đun
ZZ0000ZZ Mô-đun quá nóng
- Sự cố mô-đun thu phát ZZ0000ZZ
Liên kết các trạng thái phụ mở rộng:
Trạm biến áp Autoneg:
ZZ0000ZZ Không nhận được xác nhận từ phía ngang hàng
ZZ0000ZZ Trao đổi trang tiếp theo không thành công
- ZZ0000ZZ Mặt ngang hàng bị hỏng khi có lực
chế độ hoặc không có thỏa thuận của tốc độ
- ZZ0000ZZ Chế độ sửa lỗi chuyển tiếp
ở cả hai bên đều không khớp
- ZZ0000ZZ Không có Mẫu số chung cao nhất
Liên kết các trạng thái đào tạo:
khóa không thành công
- ZZ0000ZZ Khóa không
xảy ra trước hết thời gian
- ZZ0000ZZ Bên ngang hàng thì không
gửi tín hiệu sẵn sàng sau khi đào tạo quá trình
- ZZ0000ZZ Phía từ xa không có
sẵn sàng chưa
Liên kết các trạng thái con không khớp logic:
khóa khối
- ZZ0000ZZ Lớp con mã hóa vật lý là
không bị khóa trong giai đoạn thứ hai - khóa đánh dấu căn chỉnh
- ZZ0000ZZ Lớp con mã hóa vật lý đã thực hiện
không nhận được trạng thái căn chỉnh
- Sửa lỗi chuyển tiếp ZZ0000ZZ FC là
không bị khóa
- Sửa lỗi chuyển tiếp ZZ0000ZZ RS là
không bị khóa
Trạng thái toàn vẹn tín hiệu xấu:
- ZZ0000ZZ Hệ thống đã cố gắng
vận hành cáp ở tốc độ đó không phải là chính thức được hỗ trợ, dẫn đến vấn đề toàn vẹn tín hiệu
- ZZ0000ZZ Tín hiệu đồng hồ bên ngoài cho
SerDes quá yếu hoặc không có sẵn.
- ZZ0000ZZ Tín hiệu nhận được cho
SerDes quá yếu vì mất tín hiệu analog.
Trạm biến áp phát hành cáp:
Yêu cầu cài đặt gỡ lỗi của thiết bị. Hiện tại, chỉ có mặt nạ tin nhắn là được cung cấp.
Nội dung yêu cầu:
Đặt hoặc cập nhật cài đặt gỡ lỗi của thiết bị. Hiện tại chỉ có mặt nạ tin nhắn được hỗ trợ.
Nội dung yêu cầu:
Truy vấn cài đặt Wake-on-lan của thiết bị. Không giống như hầu hết các yêu cầu loại “GET”, ZZ0000ZZ yêu cầu (netns) đặc quyền ZZ0001ZZ vì nó (có khả năng) cung cấp mật khẩu SecureOn(tm) được bảo mật.
Nội dung yêu cầu:
Đặt hoặc cập nhật cài đặt đánh thức trên mạng.
Nội dung yêu cầu:
Nhận các tính năng của netdev như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Yêu cầu đặt các tính năng của netdev như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận các cờ riêng tư như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Đặt hoặc sửa đổi giá trị của cờ riêng của thiết bị như ZZ0000ZZ yêu cầu ioctl.
Nội dung yêu cầu:
Nhận kích thước vòng như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ ZZ0001ZZ u32 kích thước tối đa của vòng RX ZZ0002ZZ u32 kích thước tối đa của vòng mini RX ZZ0003ZZ u32 kích thước tối đa của vòng jumbo RX ZZ0004ZZ u32 kích thước tối đa của vòng TX Kích thước ZZ0005ZZ u32 của vòng RX Kích thước ZZ0006ZZ u32 của vòng mini RX Kích thước ZZ0007ZZ u32 của vòng jumbo RX Kích thước ZZ0008ZZ u32 của vòng TX Kích thước bộ đệm ZZ0009ZZ u32 trên vòng ZZ0010ZZ u8 TCP tiêu đề/tách dữ liệu ZZ0011ZZ u32 Kích thước của TX/RX CQE Cờ ZZ0012ZZ u8 của chế độ Đẩy TX Cờ ZZ0013ZZ u8 của chế độ Đẩy RX Kích thước ZZ0014ZZ u32 của bộ đệm đẩy TX ZZ0015ZZ u32 kích thước tối đa của bộ đệm đẩy TX Ngưỡng ZZ0016ZZ u32 của
phân chia tiêu đề/dữ liệu
- Ngưỡng tối đa của ZZ0017ZZ u32
phân chia tiêu đề/dữ liệu
ZZ0000ZZ cho biết thiết bị có thể sử dụng được với nhận không sao chép TCP lật trang (ZZ0001ZZ). Nếu được bật, thiết bị sẽ được cấu hình để đặt tiêu đề khung và dữ liệu vào bộ đệm riêng biệt. Cấu hình thiết bị phải đảm bảo có thể nhận được các trang bộ nhớ dữ liệu đầy đủ, ví dụ vì MTU đủ cao hoặc thông qua HW-GRO.
Cờ ZZ0000ZZ được sử dụng để kích hoạt nhanh bộ mô tả đường dẫn gửi hoặc nhận gói tin. Trong đường dẫn thông thường, trình điều khiển điền mô tả vào DRAM và thông báo cho phần cứng NIC. Trong đường dẫn nhanh, trình điều khiển đẩy bộ mô tả vào thiết bị thông qua ghi MMIO, do đó giảm độ trễ. Tuy nhiên, việc kích hoạt tính năng này có thể làm tăng chi phí CPU. Trình điều khiển có thể thực thi bổ sung cho mỗi gói kiểm tra tính đủ điều kiện (ví dụ: về kích thước gói).
ZZ0000ZZ chỉ định số byte tối đa của một gói được truyền, trình điều khiển có thể đẩy trực tiếp đến thiết bị cơ bản (chế độ ‘đẩy’). Việc đẩy một số byte tải trọng tới thiết bị có lợi thế của việc giảm độ trễ cho các gói nhỏ bằng cách tránh ánh xạ DMA (tương tự như tham số ZZ0001ZZ) cũng như cho phép cơ bản thiết bị xử lý các tiêu đề gói trước khi lấy tải trọng của nó. Điều này có thể giúp thiết bị thực hiện các hành động nhanh chóng dựa trên tiêu đề của gói. Điều này tương tự với tham số “tx-copybreak”, sao chép gói tin vào một vùng bộ nhớ DMA được phân bổ trước thay vì ánh xạ bộ nhớ mới. Tuy nhiên, Tham số tx-push-buff sao chép gói trực tiếp vào thiết bị để cho phép thiết bị để thực hiện hành động nhanh hơn trên gói.
RINGS_SET¶
Đặt kích thước vòng như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận số lượng kênh như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Kênh nhận tối đa ZZ0001ZZ u32 Kênh truyền tối đa ZZ0002ZZ u32 ZZ0003ZZ u32 max các kênh khác Kênh kết hợp tối đa ZZ0004ZZ u32 ZZ0005ZZ u32 nhận số kênh Số kênh truyền ZZ0006ZZ u32 ZZ0007ZZ u32 số kênh khác Số kênh kết hợp ZZ0008ZZ u32 ====================================== ====== =============================
CHANNELS_SET¶
Đặt số lượng kênh như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận các tham số hợp nhất như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Độ trễ ZZ0001ZZ u32 (chúng tôi), Rx bình thường Gói tối đa ZZ0002ZZ u32, Rx bình thường Độ trễ ZZ0003ZZ u32 (chúng tôi), Rx trong IRQ Gói tối đa ZZ0004ZZ u32, Rx trong IRQ Độ trễ ZZ0005ZZ u32 (chúng tôi), Tx bình thường Gói tối đa ZZ0006ZZ u32, Tx bình thường Độ trễ ZZ0007ZZ u32 (chúng tôi), Tx trong IRQ Gói ZZ0008ZZ u32 IRQ, Tx trong IRQ ZZ0009ZZ u32 trì hoãn cập nhật số liệu thống kê ZZ0010ZZ bool thích ứng Rx hợp nhất ZZ0011ZZ bool thích ứng Tx kết hợp Ngưỡng ZZ0012ZZ u32 cho tốc độ thấp Độ trễ ZZ0013ZZ u32 (chúng tôi), Rx thấp Gói tối đa ZZ0014ZZ u32, Rx thấp Độ trễ ZZ0015ZZ u32 (chúng tôi), Tx thấp Gói tối đa ZZ0016ZZ u32, Tx thấp Ngưỡng ZZ0017ZZ u32 cho tốc độ cao Độ trễ ZZ0018ZZ u32 (chúng tôi), Rx cao Gói tối đa ZZ0019ZZ u32, Rx cao Độ trễ ZZ0020ZZ u32 (chúng tôi), Tx cao Gói tối đa ZZ0021ZZ u32, Tx cao Khoảng thời gian lấy mẫu tốc độ ZZ0022ZZ u32 Chế độ đặt lại bộ hẹn giờ bool ZZ0023ZZ, Tx Chế độ đặt lại bộ hẹn giờ bool ZZ0024ZZ, Rx Kích thước tổng hợp tối đa ZZ0025ZZ u32, Tx Gói tổng hợp tối đa ZZ0026ZZ u32, Tx ZZ0027ZZ u32 thời gian (chúng tôi), aggr, Tx Cấu hình lồng nhau của ZZ0028ZZ của DIM, Rx Hồ sơ lồng nhau của ZZ0029ZZ của DIM, Tx Gói tối đa ZZ0030ZZ u32, Rx CQE Độ trễ ZZ0031ZZ u32 (ns), Rx CQE ============================================ ====== ==========================
Các thuộc tính chỉ được đưa vào trong phản hồi nếu giá trị của chúng không bằng 0 hoặc bit tương ứng trong ZZ0000ZZ được đặt (tức là chúng được khai báo là được hỗ trợ bởi trình điều khiển).
Chế độ đặt lại hẹn giờ (ZZ0000ZZ và ZZ0001ZZ) kiểm soát sự tương tác giữa gói đến và các tham số độ trễ dựa trên thời gian khác nhau. Theo mặc định bộ hẹn giờ là dự kiến sẽ hạn chế độ trễ tối đa giữa bất kỳ gói đến/đi nào và ngắt tương ứng. Ở chế độ này, bộ đếm thời gian phải được bắt đầu bằng gói đến (đôi khi gửi ngắt trước đó) và đặt lại khi ngắt được giao. Đặt thuộc tính thích hợp thành 1 sẽ bật chế độ ZZ0002ZZ, trong đó mỗi sự kiện gói sẽ đặt lại bộ đếm thời gian. Trong chế độ này, bộ đếm thời gian được sử dụng để buộc ngắt nếu hàng đợi không hoạt động, trong khi hàng đợi bận phụ thuộc vào gói giới hạn kích hoạt ngắt.
Tập hợp Tx bao gồm việc sao chép các khung vào một bộ đệm liền kề để chúng có thể được gửi dưới dạng một hoạt động IO duy nhất. ZZ0000ZZ mô tả kích thước tối đa tính bằng byte cho bộ đệm được gửi. ZZ0001ZZ mô tả số lượng khung hình tối đa có thể được tổng hợp thành một bộ đệm duy nhất. ZZ0002ZZ mô tả lượng thời gian trong usecs, được tính kể từ khi gói đầu tiên đến trong một khối tổng hợp, sau đó gói khối nên được gửi đi. Tính năng này chủ yếu được quan tâm đối với các thiết bị USB cụ thể không đáp ứng được tốt với việc truyền URB cỡ nhỏ thường xuyên.
ZZ0000ZZ và ZZ0001ZZ tham khảo đến các thông số DIM, xem ZZ0002ZZ.
Kết hợp Rx CQE cho phép kết hợp nhiều gói đã nhận thành một Mục nhập hàng đợi hoàn thành duy nhất (CQE) hoặc ghi lại bộ mô tả. ZZ0000ZZ mô tả số lượng tối đa các khung có thể được hợp nhất thành CQE hoặc writeback. ZZ0001ZZ mô tả thời gian tối đa tính bằng nano giây sau gói đầu tiên đến trong CQE được hợp nhất hoặc viết lại sẽ được gửi.
COALESCE_SET¶
Đặt các tham số hợp nhất như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận cài đặt khung tạm dừng như yêu cầu ioctl ZZ0000ZZ.
Nội dung yêu cầu:
Đặt các tham số tạm dừng như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận các cài đặt Ethernet tiết kiệm năng lượng như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Đặt các tham số Ethernet tiết kiệm năng lượng như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Nhận thông tin về dấu thời gian như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ Cờ bit ZZ0001ZZ SO_TIMESTAMPING Các loại Tx được hỗ trợ bit ZZ0002ZZ Bộ lọc Rx được hỗ trợ bit ZZ0003ZZ Chỉ số đồng hồ hw ZZ0004ZZ u32 PTP hw Thống kê về dấu thời gian CTNH lồng nhau của ZZ0005ZZ ====================================== ====== =============================
ZZ0000ZZ vắng mặt nếu không có PHC liên quan (có không có giá trị đặc biệt cho trường hợp này). Các thuộc tính bitset bị bỏ qua nếu chúng sẽ trống (không có bit nào được đặt).
Nội dung phản hồi thống kê đánh dấu thời gian phần cứng bổ sung:
Bắt đầu kiểm tra cáp.
Nội dung yêu cầu:
Bắt đầu kiểm tra cáp và báo cáo dữ liệu TDR thô
Nội dung yêu cầu:
ZZ0006ZZ lồng nhau ZZ0007ZZ +---------------------------------------------+--------+--------------+ ZZ0008ZZ lồng nhau ZZ0009ZZ ++-----------------------------------------------+--------+--------------+ ZZ0010ZZ ZZ0002ZZ ZZ0011ZZ khoảng cách dữ liệu đầu tiên | ++-+----------------------------------------------+--------+--------------+ ZZ0012ZZ ZZ0003ZZ ZZ0013ZZ khoảng cách dữ liệu cuối cùng | ++-+----------------------------------------------+--------+--------------+ ZZ0014ZZ ZZ0004ZZ ZZ0015ZZ khoảng cách mỗi bước | ++-+----------------------------------------------+--------+--------------+ Cặp ZZ0016ZZ ZZ0005ZZ ZZ0017ZZ để test | ++-+----------------------------------------------+--------+--------------+
ETHTOOL_A_CABLE_TEST_TDR_CFG là tùy chọn, cũng như tất cả các thành viên của tổ. Tất cả khoảng cách được thể hiện bằng cm. PHY mất khoảng cách làm hướng dẫn và làm tròn đến khoảng cách gần nhất thực sự hỗ trợ. Nếu một cặp được thông qua thì chỉ có một cặp đó sẽ được đã thử nghiệm. Nếu không thì tất cả các cặp đều được kiểm tra.
Nội dung thông báo:
Dữ liệu TDR thô được thu thập bằng cách gửi xung xuống cáp và ghi lại biên độ của xung phản xạ trong một khoảng cách nhất định.
Có thể mất vài giây để thu thập dữ liệu TDR, đặc biệt nếu toàn bộ 100 mét được thăm dò ở khoảng cách 1 mét. Khi bài kiểm tra được thực hiện đã bắt đầu, một thông báo sẽ được gửi chỉ chứa ETHTOOL_A_CABLE_TEST_TDR_STATUS với giá trị ETHTOOL_A_CABLE_TEST_NTF_STATUS_STARTED.
Khi bài kiểm tra hoàn thành, thông báo thứ hai sẽ được gửi chứa ETHTOOL_A_CABLE_TEST_TDR_STATUS với giá trị Dữ liệu ETHTOOL_A_CABLE_TEST_NTF_STATUS_COMPLETED và TDR.
Tin nhắn có thể tùy ý chứa biên độ của xung gửi xuống cáp. Điều này được đo bằng mV. Sự phản ánh không nên lớn hơn xung truyền đi.
Trước dữ liệu TDR thô phải là ETHTOOL_A_CABLE_TDR_NEST_STEP tổ chứa thông tin về khoảng cách dọc theo cáp cho lần đọc đầu tiên, lần đọc cuối cùng và bước giữa mỗi lần đọc đọc. Khoảng cách được đo bằng cm. Đây phải là những giá trị chính xác mà PHY đã sử dụng. Những điều này có thể khác với những gì người dùng được yêu cầu, nếu độ phân giải đo gốc lớn hơn 1 cm.
Đối với mỗi bước dọc theo cáp, một ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE được được sử dụng để báo cáo biên độ phản xạ của một cặp nhất định.
ZZ0018ZZ lồng nhau ZZ0019ZZ +---------------------------------------------+--------+----------------------+ ZZ0020ZZ u8 ZZ0021ZZ +---------------------------------------------+--------+----------------------+ ZZ0022ZZ lồng nhau ZZ0023ZZ ++--------------------------------------------------+--------+----------------------+ ZZ0024ZZ ZZ0003ZZ ZZ0025ZZ TX Biên độ xung | +-+-+------------------------------------------+--------+----------------------+ ZZ0026ZZ ZZ0027ZZ s16 ZZ0028ZZ +-+-+------------------------------------------+--------+----------------------+ Thông tin bước ZZ0029ZZ ZZ0005ZZ ZZ0030ZZ TDR | +-+-+------------------------------------------+--------+----------------------+ ZZ0031ZZ ZZ0032ZZ u32 ZZ0033ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0034ZZ ZZ0035ZZ u32 ZZ0036ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0037ZZ ZZ0038ZZ u32 ZZ0039ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0040ZZ ZZ0009ZZ ZZ0041ZZ Biên độ phản xạ | +-+-+------------------------------------------+--------+----------------------+ ZZ0042ZZ ZZ0043ZZ u8 ZZ0044ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0045ZZ ZZ0046ZZ s16 ZZ0047ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0048ZZ ZZ0012ZZ ZZ0049ZZ Biên độ phản xạ | +-+-+------------------------------------------+--------+----------------------+ ZZ0050ZZ ZZ0051ZZ u8 ZZ0052ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0053ZZ ZZ0054ZZ s16 ZZ0055ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0056ZZ ZZ0015ZZ ZZ0057ZZ Biên độ phản xạ | +-+-+------------------------------------------+--------+----------------------+ ZZ0058ZZ ZZ0059ZZ u8 ZZ0060ZZ +-+-+------------------------------------------+--------+----------------------+ ZZ0061ZZ ZZ0062ZZ s16 ZZ0063ZZ +-+-+------------------------------------------+--------+----------------------+
TUNNEL_INFO¶
Nhận thông tin về trạng thái đường hầm mà NIC biết.
Nội dung yêu cầu:
Nhận cấu hình và trạng thái FEC giống như yêu cầu ioctl ZZ0000ZZ.
Nội dung yêu cầu:
Đặt tham số FEC như yêu cầu ZZ0000ZZ ioctl.
Nội dung yêu cầu:
Tìm nạp kết xuất dữ liệu mô-đun EEPROM. Giao diện này được thiết kế để cho phép kết xuất tối đa 1/2 trang cùng một lúc. Cái này có nghĩa là chỉ cho phép kết xuất 128 (hoặc ít hơn) byte mà không vượt qua nửa trang ranh giới nằm ở offset 128. Đối với các trang khác 0, chỉ có 128 byte cao là có thể truy cập được.
Nội dung yêu cầu:
Nhận số liệu thống kê tiêu chuẩn cho giao diện. Lưu ý rằng đây không phải là việc triển khai lại ZZ0000ZZ đã làm lộ ra số liệu thống kê.
Nội dung yêu cầu:
ETHTOOL_STATS_ETH_MAC eth-mac Thống kê IEEE 802.3 MAC cơ bản (30.3.1.1.*) ETHTOOL_STATS_ETH_PHY eth-phy Thống kê cơ bản IEEE 802.3 PHY (30.3.2.1.*) ETHTOOL_STATS_ETH_CTRL eth-ctrl Thống kê cơ bản IEEE 802.3 MAC Ctrl (30.3.3.*) Thống kê ETHTOOL_STATS_RMON rmon RMON (RFC 2819) ETHTOOL_STATS_PHY phy Số liệu thống kê bổ sung về PHY, không được xác định bởi IEEE ======================= ============================================================
Mỗi nhóm phải có một ZZ0000ZZ tương ứng trong thư trả lời. ZZ0001ZZ xác định tổ thống kê của nhóm nào chứa. ZZ0002ZZ xác định ID bộ chuỗi cho tên của số liệu thống kê trong nhóm, nếu có.
Số liệu thống kê được thêm vào tổ ZZ0000ZZ bên dưới ZZ0001ZZ. ZZ0002ZZ nên chứa thuộc tính 8 byte (u64) đơn bên trong - loại thuộc tính đó là ID thống kê và giá trị là giá trị của thống kê. Mỗi nhóm có cách giải thích riêng về ID thống kê. ID thuộc tính tương ứng với các chuỗi từ bộ chuỗi được xác định bởi ZZ0003ZZ. Số liệu thống kê phức tạp (chẳng hạn như biểu đồ RMON mục) cũng được liệt kê bên trong ZZ0004ZZ và không có một chuỗi được xác định trong tập hợp chuỗi.
Bộ đếm “biểu đồ” RMON đếm số lượng gói trong phạm vi kích thước nhất định. Bởi vì RFC không chỉ định phạm vi vượt quá 1518 thiết bị MTU tiêu chuẩn khác nhau về định nghĩa của xô. Vì lý do này, định nghĩa về phạm vi gói được giao cho mỗi người lái xe.
Tổ ZZ0000ZZ và ZZ0001ZZ chứa các thuộc tính sau:
Thống kê RFC thấp cao =============================== ==== ==== etherStatsPkts64Octets 0 64 etherStatsPkts512to1023Octets 512 1023 =============================== ==== ====
ZZ0000ZZ là tùy chọn. Tương tự như ZZ0001ZZ, nó nhận các giá trị từ ZZ0002ZZ. Nếu vắng mặt trong yêu cầu, số liệu thống kê sẽ được được cung cấp thuộc tính ZZ0003ZZ trong phản hồi bằng ZZ0004ZZ.
PHC_VCLOCKS_GET¶
Truy vấn thông tin đồng hồ ảo PHC của thiết bị.
Nội dung yêu cầu:
Nhận thông số mô-đun thu phát.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Chính sách chế độ nguồn ZZ0001ZZ u8 Chế độ năng lượng hoạt động ZZ0002ZZ u8 ======================================= ====== =============================
Thuộc tính ZZ0000ZZ tùy chọn mã hóa Chính sách chế độ nguồn của mô-đun thu phát được thực thi bởi máy chủ. Chính sách mặc định phụ thuộc vào trình điều khiển, nhưng “tự động” là mặc định được đề xuất và nó phải là được triển khai bởi các trình điều khiển và trình điều khiển mới nơi tuân thủ hành vi cũ không quan trọng.
Thuộc tính ZZ0000ZZ tùy chọn mã hóa hoạt động chính sách chế độ nguồn của mô-đun thu phát. Nó chỉ được báo cáo khi một mô-đun đã được cắm vào. Các giá trị có thể là:
MODULE_SET¶
Đặt tham số mô-đun thu phát.
Nội dung yêu cầu:
Nhận thuộc tính PSE.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ ZZ0001ZZ u32 Trạng thái hoạt động của PoDL
Chức năng PSE
- Trạng thái phát hiện nguồn điện ZZ0002ZZ u32 của
PoDL PSE.
- ZZ0003ZZ u32 Trạng thái hoạt động của PoE
Chức năng PSE.
- Trạng thái phát hiện nguồn điện ZZ0004ZZ u32 của
PoE PSE.
Lớp năng lượng ZZ0005ZZ u32 của PoE PSE. ZZ0006ZZ u32 công suất thực tế được rút ra trên
PoE PSE.
- Trạng thái mở rộng nguồn ZZ0007ZZ u32 của
PoE PSE.
- Trạng thái phụ mở rộng nguồn ZZ0008ZZ u32 của
PoE PSE.
- Nguồn điện được cấu hình hiện tại của ZZ0009ZZ u32
giới hạn của PoE PSE.
- ZZ0010ZZ lồng nhau Giới hạn công suất được hỗ trợ
các phạm vi cấu hình.
ZZ0011ZZ u32 Chỉ mục của miền năng lượng PSE ZZ0012ZZ u32 Cấu hình ưu tiên tối đa
trên PoE PSE
- ZZ0013ZZ u32 Ưu tiên của PoE PSE
hiện đang được cấu hình
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định trạng thái hoạt động của các chức năng PoDL PSE. Tình trạng hoạt động của Chức năng PSE có thể được thay đổi bằng ZZ0001ZZ hành động. Thuộc tính này tương ứng với ZZ0002ZZ 30.15.1.1.2 aPoDLPSEAdminState. Các giá trị có thể là:
Điều tương tự cũng xảy ra với việc triển khai ZZ0000ZZ ZZ0001ZZ 30.9.1.1.2 aPSEAdminState.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định trạng thái phát hiện nguồn điện của PoDL PSE. Trạng thái phụ thuộc vào PSE nội bộ máy trạng thái và hỗ trợ phân loại PD tự động. Thuộc tính này tương ứng với ZZ0001ZZ 30.15.1.1.3 aPoDLPSEPowerDetectionStatus. Các giá trị có thể là:
Điều tương tự cũng xảy ra với việc triển khai ZZ0000ZZ ZZ0001ZZ 30.9.1.1.5 aPSEPowerDetectionStatus.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định loại sức mạnh của C33 PSE. Nó phụ thuộc vào lớp được đàm phán giữa PSE và PD. Thuộc tính này tương ứng với ZZ0001ZZ 30.9.1.1.8 aPSEPower Phân loại.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định công suất thực tế do C33 PSE tiêu thụ. Thuộc tính này tương ứng với ZZ0001ZZ 30.9.1.1.23 aPSEActuualPower. Công suất thực tế được báo cáo tính bằng mW.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định trạng thái lỗi mở rộng của C33 PSE. Các giá trị có thể là:
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định trạng thái lỗi mở rộng của C33 PSE. Các giá trị có thể là: Các giá trị có thể là:
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn xác định giới hạn công suất C33 PSE tính bằng mW.
Khi đặt thuộc tính lồng nhau ZZ0000ZZ tùy chọn xác định phạm vi giới hạn công suất C33 PSE thông qua ZZ0001ZZ và ZZ0002ZZ. Nếu bộ điều khiển hoạt động với các lớp cố định, giá trị tối thiểu và tối đa sẽ là bằng nhau.
Thuộc tính ZZ0000ZZ xác định chỉ số sức mạnh của PSE miền.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn sẽ xác định giá trị ưu tiên tối đa PSE. Khi được đặt, các thuộc tính ZZ0001ZZ tùy chọn sẽ được sử dụng để xác định mức độ ưu tiên PSE hiện được cấu hình. Để biết mô tả về các thuộc tính ưu tiên của PSE, hãy xem ZZ0002ZZ.
PSE_SET¶
Đặt tham số PSE.
Nội dung yêu cầu:
Thông báo sự kiện PSE.
Nội dung thông báo:
Nhận bảng hướng dẫn, khóa băm và thông tin hàm băm liên quan đến một Bối cảnh RSS của một giao diện tương tự như yêu cầu ioctl ZZ0000ZZ.
Nội dung yêu cầu:
ZZ0000ZZ chỉ định số ngữ cảnh RSS nào cần truy vấn, nếu không đặt bối cảnh 0 (ngữ cảnh chính) sẽ được truy vấn. Các bãi rác có thể được lọc theo thiết bị (chỉ liệt kê bối cảnh của một netdev nhất định). Lọc đơn số ngữ cảnh không được hỗ trợ nhưng ZZ0001ZZ có thể được sử dụng để bắt đầu kết xuất bối cảnh từ số đã cho (chủ yếu được sử dụng để bỏ qua ngữ cảnh 0 và chỉ kết xuất các ngữ cảnh bổ sung).
Nội dung phản hồi hạt nhân:
Thuộc tính ETHTOOL_A_RSS_HFUNC là bitmap biểu thị hàm băm đang được sử dụng. Các tùy chọn được hỗ trợ hiện tại là toeplitz, xor hoặc crc32. Thuộc tính ETHTOOL_A_RSS_INDIR trả về bảng hướng dẫn RSS trong đó mỗi byte cho biết số hàng đợi. Thuộc tính ETHTOOL_A_RSS_INPUT_XFRM là một bitmap cho biết loại chuyển đổi được áp dụng cho các trường giao thức đầu vào trước khi được cung cấp cho RSS hfunc. Các tùy chọn được hỗ trợ hiện tại là đối xứng-xor và đối xứng-hoặc-xor. ETHTOOL_A_RSS_FLOW_HASH mang bitmask loại mỗi luồng trong đó tiêu đề các trường được bao gồm trong tính toán băm.
RSS_SET¶
Nội dung yêu cầu:
ZZ0000ZZ là bảng RSS tối thiểu mà người dùng mong đợi. hạt nhân và trình điều khiển thiết bị có thể sao chép bảng nếu nó nhỏ hơn bảng nhỏ nhất kích thước được thiết bị hỗ trợ. Ví dụ: nếu người dùng yêu cầu ZZ0001ZZ nhưng thiết bị cần ít nhất 8 mục - bảng thực đang được sử dụng sẽ ZZ0002ZZ. Hầu hết các thiết bị đều yêu cầu kích thước bàn để cấp nguồn bằng 2, vì vậy các bảng có kích thước không phải là lũy thừa của 2 sẽ có khả năng bị từ chối. Sử dụng bảng có kích thước 0 sẽ đặt lại bảng hướng dẫn về mặc định.
RSS_CREATE_ACT¶
Nội dung yêu cầu:
Nội dung phản hồi hạt nhân:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ |
|
Số ngữ cảnh ZZ0001ZZ u32 |
Tạo bối cảnh RSS bổ sung, nếu không có ZZ0000ZZ hạt nhân được chỉ định sẽ tự động phân bổ một hạt nhân.
RSS_DELETE_ACT¶
Nội dung yêu cầu:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ |
|
Số ngữ cảnh ZZ0001ZZ u32 |
Xóa bối cảnh RSS bổ sung.
PLCA_GET_CFG¶
Nhận IEEE 802.3cg-2019 Điều khoản 148 Tránh va chạm lớp vật lý (PLCA) Thuộc tính lớp con hòa giải (RS).
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ ZZ0001ZZ u16 Hỗ trợ quản lý PLCA
giao diện tiêu chuẩn/phiên bản
ZZ0002ZZ u8 PLCA Quản trị viên ZZ0003ZZ u32 PLCA ID nút cục bộ duy nhất ZZ0004ZZ u32 Số lượng nút PLCA trên
mạng, bao gồm cả điều phối viên
- Bộ đếm thời gian cơ hội truyền ZZ0005ZZ u32
giá trị tính theo thời gian bit (BT)
- ZZ0006ZZ u32 Số lượng gói bổ sung
nút được phép gửi trong một ĐẾN duy nhất
- ZZ0007ZZ u32 Đã đến lúc chờ đợi MAC
truyền một khung hình mới trước chấm dứt vụ nổ
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết tiêu chuẩn và phiên bản mà giao diện quản lý PLCA tuân thủ. Khi chưa được thiết lập, giao diện dành riêng cho nhà cung cấp và (có thể) do trình điều khiển cung cấp. Liên minh OPEN SIG chỉ định bản đồ đăng ký tiêu chuẩn cho PHY 10BASE-T1S nhúng Lớp con hòa giải PLCA. Xem “Quản lý 10BASE-T1S PLCA Đăng ký” tại ZZ0001ZZ
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết trạng thái hành chính của PLCA RS. Khi không được đặt, nút hoạt động ở chế độ “đơn giản” Chế độ CSMA/CD. Tùy chọn này tương ứng với ZZ0001ZZ 30.16.1.1.1 aPLCAAdminState / 30.16.1.2.1 acPLCAAdminControl.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết ID nút cục bộ được cấu hình của PHY. ID này xác định việc truyền nào cơ hội (TO) được dành riêng cho nút truyền vào. Tùy chọn này là tương ứng với ZZ0001ZZ 30.16.1.1.4 aPLCALocalNodeID. hợp lệ phạm vi cho thuộc tính này là [0 .. 255] trong đó 255 có nghĩa là “không được định cấu hình”.
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết được định cấu hình số lượng nút PLCA tối đa trên phân đoạn trộn. Số này xác định tổng số cơ hội truyền được tạo ra trong một Chu trình PLCA. Thuộc tính này chỉ liên quan đến điều phối viên PLCA, nút có aPLCALocalNodeID được đặt thành 0. Các nút theo dõi bỏ qua cài đặt này. Tùy chọn này tương ứng với ZZ0001ZZ 30.16.1.1.3 aPLCANodeCount. Phạm vi hợp lệ cho thuộc tính này là [1 .. 255].
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết giá trị được cấu hình của bộ định thời cơ hội truyền theo thời gian bit. Giá trị này phải được đặt bằng nhau trên tất cả các nút chia sẻ phương tiện để PLCA hoạt động một cách chính xác. Tùy chọn này tương ứng với ZZ0001ZZ 30.16.1.1.5 aPLCATransmitOpportunityTimer. Phạm vi hợp lệ cho thuộc tính này là [0 .. 255].
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết số lượng gói bổ sung được cấu hình mà nút được phép gửi trong một cơ hội truyền đơn. Theo mặc định, thuộc tính này là 0, nghĩa là nút chỉ có thể gửi một khung hình cho mỗi TO. Khi lớn hơn 0, PLCA RS giữ TO sau bất kỳ lần truyền nào, chờ MAC gửi khung mới cho tối đa aPLCABurstTimer BT. Điều này chỉ có thể xảy ra một số lần trên mỗi PLCA chu kỳ lên đến giá trị của tham số này. Sau đó, vụ nổ kết thúc và việc đếm TO bình thường được tiếp tục. Tùy chọn này tương ứng với ZZ0001ZZ 30.16.1.1.6 aPLCAMaxBurstCount. Phạm vi hợp lệ cho việc này thuộc tính là [0 .. 255].
Khi được đặt, thuộc tính ZZ0000ZZ tùy chọn cho biết cách nhiều lần bit PLCA RS đợi MAC bắt đầu truyền mới khi aPLCAMaxBurstCount lớn hơn 0. Nếu MAC không gửi được lệnh mới khung trong thời gian này, cụm kết thúc và quá trình đếm TO tiếp tục. Ngược lại, khung mới sẽ được gửi như một phần của cụm hiện tại. Tùy chọn này tương ứng với ZZ0001ZZ 30.16.1.1.7 aPLCABurstTimer. các phạm vi hợp lệ cho thuộc tính này là [0 .. 255]. Mặc dù, giá trị phải là được đặt lớn hơn thời gian Khoảng cách giữa các khung (IFG) của MAC (cộng với một số lề) để chế độ chụp liên tục PLCA hoạt động như dự định.
PLCA_SET_CFG¶
Đặt thông số PLCA RS.
Nội dung yêu cầu:
Nhận thông tin trạng thái PLCA RS.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Trạng thái hoạt động của ZZ0001ZZ u8 PLCA RS ======================================= ====== ================================
Khi được đặt, thuộc tính ZZ0000ZZ cho biết nút có phát hiện sự hiện diện của BEACON trên mạng. Lá cờ này là tương ứng với ZZ0001ZZ 30.16.1.1.2 aPLCAStatus.
MM_GET¶
Truy xuất các tham số Hợp nhất 802.3 MAC.
Nội dung yêu cầu:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ ZZ0001ZZ bool được đặt nếu RX được ưu tiên và SMD-V
khung được kích hoạt
- ZZ0002ZZ bool được đặt nếu TX của các khung có thể chiếm trước là
được kích hoạt về mặt quản trị (có thể không hoạt động nếu xác minh không thành công)
- ZZ0003ZZ bool được đặt nếu TX của các khung có thể chiếm trước là
kích hoạt hoạt động
- ZZ0004ZZ u32 kích thước tối thiểu của truyền
các đoạn không phải cuối cùng, tính bằng octet
- ZZ0005ZZ u32 kích thước tối thiểu nhận được không phải cuối cùng
các mảnh, tính bằng octet
- Bool ZZ0006ZZ được đặt nếu TX của khung SMD-V là
kích hoạt quản trị
Trạng thái ZZ0007ZZ u8 của chức năng xác minh Độ trễ ZZ0008ZZ u32 giữa các lần xác minh Khoảng thời gian xác minh tối đa ZZ0009ZZ` u32
được hỗ trợ bởi thiết bị
- ZZ0010ZZ lồng nhau IEEE 802.3-2018 điều khoản phụ 30.14.1
Bộ đếm thống kê oMACMergeEntity
Các thuộc tính được trình điều khiển thiết bị điền thông qua các mục sau cấu trúc:
ZZ0000ZZ sẽ báo cáo một trong các giá trị từ
Nếu ZZ0000ZZ được chuyển là sai trong ZZ0001ZZ lệnh, ZZ0002ZZ sẽ báo cáo ZZ0003ZZ hoặc ZZ0004ZZ, nếu không nó sẽ báo cáo một trong các trạng thái khác.
Chúng tôi khuyên các trình điều khiển nên bắt đầu với pMAC bị vô hiệu hóa và bật nó khi yêu cầu không gian người dùng. Người ta cũng khuyến nghị rằng không gian người dùng không phụ thuộc vào các giá trị mặc định từ các yêu cầu ZZ0000ZZ.
ZZ0000ZZ được báo cáo nếu ZZ0001ZZ được đặt trong ZZ0002ZZ. Thuộc tính sẽ trống nếu trình điều khiển không báo cáo bất kỳ số liệu thống kê. Trình điều khiển điền vào số liệu thống kê sau đây cấu trúc:
MM_SET¶
Sửa đổi cấu hình của lớp Hợp nhất 802.3 MAC.
Nội dung yêu cầu:
Nhấp nháy phần mềm mô-đun thu phát.
Nội dung yêu cầu:
Truy xuất thông tin về Ethernet PHY nhất định đang nằm trên liên kết. DO hoạt động trả về tất cả thông tin có sẵn về dev->phydev. Người dùng cũng có thể chỉ định PHY_INDEX, trong trường hợp đó yêu cầu DO trả về thông tin về điều đó PHY cụ thể.
Vì có thể có nhiều hơn một PHY nên thao tác DUMP có thể được sử dụng để liệt kê các PHY hiện diện trên một giao diện nhất định, bằng cách chuyển chỉ mục hoặc tên giao diện vào yêu cầu kết xuất.
Để biết thêm thông tin, hãy tham khảo ZZ0000ZZ
Nội dung yêu cầu:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ ZZ0001ZZ u32 chỉ số duy nhất của phy, có thể
được sử dụng cho phy cụ thể yêu cầu
ZZ0002ZZ xâu chuỗi tên trình điều khiển phy ZZ0003ZZ xâu chuỗi tên thiết bị phy ZZ0004ZZ u32 loại thiết bị phy này
kết nối với
- ZZ0005ZZ u32 chỉ số PHY của thượng nguồn
PHY
- Chuỗi ZZ0006ZZ nếu PHY này được kết nối với
cha mẹ của nó là PHY thông qua SFP xe buýt, tên của xe buýt sfp này
- Chuỗi ZZ0007ZZ nếu phy điều khiển bus sfp,
tên của xe buýt sfp
Khi ZZ0000ZZ là PHY_UPSTREAM_PHY, cha mẹ của PHY là một chiếc PHY khác.
TSCONFIG_GET¶
Truy xuất thông tin về nguồn đánh dấu thời gian phần cứng hiện tại và cấu hình.
Nó tương tự như yêu cầu ioctl ZZ0000ZZ không được dùng nữa.
Nội dung yêu cầu:
Tiêu đề yêu cầu lồng nhau ZZ0000ZZ ZZ0001ZZ nhà cung cấp đồng hồ hw PTP lồng nhau ZZ0002ZZ bitset hwtstamp loại Tx Bộ lọc bitset hwtstamp Rx ZZ0003ZZ Cờ hwtstamp ZZ0004ZZ u32 ========================================== ====== ===============================
Khi đặt thuộc tính ZZ0000ZZ sẽ xác định nguồn của nhà cung cấp tính năng đánh dấu thời gian hw. Nó được sáng tác bởi Thuộc tính ZZ0001ZZ mô tả chỉ mục của thiết bị PTP và ZZ0002ZZ mô tả vòng loại của dấu thời gian.
Khi đặt ZZ0000ZZ, ZZ0001ZZ và thuộc tính ZZ0002ZZ xác định Tx loại, bộ lọc Rx và các cờ được định cấu hình cho dấu thời gian hw hiện tại nhà cung cấp. Các thuộc tính được truyền tới trình điều khiển thông qua các bước sau cấu trúc:
TSCONFIG_SET¶
Đặt thông tin về nguồn đánh dấu thời gian phần cứng hiện tại và cấu hình.
Nó tương tự như yêu cầu ioctl ZZ0000ZZ không được dùng nữa.
Nội dung yêu cầu:
Truy xuất thông tin chẩn đoán Lỗi Bình phương Trung bình (MSE) chi tiết từ PHY.
Nội dung yêu cầu:
Tiêu đề trả lời lồng nhau ZZ0000ZZ Thông tin về khả năng/quy mô lồng nhau của ZZ0001ZZ dành cho MSE
số đo
Ảnh chụp nhanh lồng nhau ZZ0002ZZ cho Kênh A Ảnh chụp nhanh lồng nhau ZZ0003ZZ cho Kênh B Ảnh chụp nhanh lồng nhau ZZ0004ZZ cho Kênh C Ảnh chụp nhanh lồng nhau ZZ0005ZZ cho Kênh D Ảnh chụp nhanh lồng nhau ZZ0006ZZ cho kênh kém nhất Ảnh chụp nhanh lồng nhau ZZ0007ZZ để tổng hợp trên toàn liên kết =========================================== ===================================
Khả năng của MSE¶
Thuộc tính lồng nhau này báo cáo các thuộc tính về khả năng/điều chỉnh quy mô được sử dụng để giải thích các giá trị ảnh chụp nhanh.
ZZ0000ZZ uint giá trị trung bình MSE ZZ0001ZZ uint đỉnh hiện tại MSE ZZ0002ZZ uint đỉnh trường hợp xấu nhất MSE ============================================ ====== =====================
Trong mỗi tổ kênh, chỉ có các số liệu được PHY hỗ trợ mới xuất hiện.
Xem tài liệu về hạt nhân ZZ0000ZZ trong ZZ0001ZZ.
Yêu cầu dịch¶
Bảng sau ánh xạ các lệnh ioctl tới các lệnh netlink cung cấp chức năng. Các mục có “n/a” ở cột bên phải là các lệnh không đã có sự thay thế liên kết mạng của họ chưa. Các mục “n/a” ở cột bên trái chỉ có liên kết mạng.
- ZZ0000ZZ ZZ0001ZZ
ZZ0002ZZ
- ZZ0003ZZ ZZ0004ZZ
ZZ0005ZZ
ZZ0006ZZ không áp dụng ZZ0007ZZ không áp dụng ZZ0008ZZ ZZ0009ZZ ZZ0010ZZ ZZ0011ZZ ZZ0012ZZ ZZ0013ZZ ZZ0014ZZ ZZ0015ZZ ZZ0016ZZ không áp dụng ZZ0017ZZ ZZ0018ZZ ZZ0019ZZ không áp dụng ZZ0020ZZ không áp dụng ZZ0021ZZ ZZ0022ZZ ZZ0023ZZ ZZ0024ZZ ZZ0025ZZ ZZ0026ZZ ZZ0027ZZ ZZ0028ZZ ZZ0029ZZ ZZ0030ZZ ZZ0031ZZ ZZ0032ZZ ZZ0033ZZ ZZ0034ZZ ZZ0035ZZ ZZ0036ZZ ZZ0037ZZ ZZ0038ZZ ZZ0039ZZ ZZ0040ZZ ZZ0041ZZ ZZ0042ZZ ZZ0043ZZ ZZ0044ZZ ZZ0045ZZ không áp dụng ZZ0046ZZ ZZ0047ZZ ZZ0048ZZ không áp dụng ZZ0049ZZ không áp dụng ZZ0050ZZ ZZ0051ZZ ZZ0052ZZ ZZ0053ZZ ZZ0054ZZ liên kết mạng ZZ0055ZZ ZZ0056ZZ ZZ0057ZZ ZZ0058ZZ ZZ0059ZZ ZZ0060ZZ ZZ0061ZZ ZZ0062ZZ ZZ0063ZZ ZZ0064ZZ ZZ0065ZZ ZZ0066ZZ ZZ0067ZZ ZZ0068ZZ ZZ0069ZZ ZZ0070ZZ ZZ0071ZZ ZZ0072ZZ ZZ0073ZZ ZZ0074ZZ ZZ0075ZZ ZZ0076ZZ ZZ0077ZZ ZZ0078ZZ ZZ0079ZZ ZZ0080ZZ không áp dụng ZZ0081ZZ không áp dụng ZZ0082ZZ không áp dụng ZZ0083ZZ không áp dụng ZZ0084ZZ không áp dụng ZZ0085ZZ không áp dụng ZZ0086ZZ không áp dụng ZZ0087ZZ không áp dụng ZZ0088ZZ không áp dụng ZZ0089ZZ không áp dụng ZZ0090ZZ ZZ0091ZZ ZZ0092ZZ ZZ0093ZZ ZZ0094ZZ ZZ0095ZZ ZZ0096ZZ ZZ0097ZZ ZZ0098ZZ ZZ0099ZZ ZZ0100ZZ ZZ0101ZZ ZZ0102ZZ ZZ0103ZZ ZZ0104ZZ không áp dụng ZZ0105ZZ không áp dụng ZZ0106ZZ không áp dụng ZZ0107ZZ ZZ0108ZZ ZZ0109ZZ ZZ0110ZZ ZZ0111ZZ ZZ0112ZZ ZZ0113ZZ ZZ0114ZZ ZZ0115ZZ ZZ0116ZZ ZZ0117ZZ ZZ0118ZZ ZZ0119ZZ không áp dụng ZZ0120ZZ không áp dụng ZZ0121ZZ không áp dụng ZZ0122ZZ không áp dụng ZZ0123ZZ không áp dụng ZZ0124ZZ ZZ0125ZZ
ZZ0126ZZ
- ZZ0127ZZ ZZ0128ZZ
ZZ0129ZZ
ZZ0130ZZ không áp dụng ZZ0131ZZ không áp dụng ZZ0132ZZ ZZ0133ZZ ZZ0134ZZ ZZ0135ZZ không có ZZ0136ZZ không có ZZ0137ZZ không có ZZ0138ZZ không có ZZ0139ZZ không có ZZ0140ZZ không có ZZ0141ZZ không có ZZ0142ZZ không có ZZ0143ZZ không có ZZ0144ZZ không có ZZ0145ZZ không có ZZ0146ZZ không có ZZ0147ZZ không có ZZ0148ZZ ZZ0149ZZ ZZ0150ZZ ZZ0151ZZ ZZ0152ZZ =============================================================================