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/.
Truy cập không gian người dùng MAD¶
Tệp thiết bị¶
- Mỗi cổng của mỗi thiết bị InfiniBand có một thiết bị “umad” và một
thiết bị “issm” được đính kèm. Ví dụ: HCA hai cổng sẽ có hai thiết bị umad và hai thiết bị issm, trong khi switch sẽ có một thiết bị thiết bị của từng loại (đối với cổng switch 0).
Tạo đại lý MAD¶
- Một tác nhân MAD có thể được tạo bằng cách điền vào cấu trúc ib_user_mad_reg_req
và sau đó gọi IB_USER_MAD_REGISTER_AGENT ioctl trên một tệp mô tả cho tập tin thiết bị thích hợp. Nếu việc đăng ký yêu cầu thành công, id 32 bit sẽ được trả về trong cấu trúc. Ví dụ:
- struct ib_user_mad_reg_req req = { /* ... */ };
ret = ioctl(fd, IB_USER_MAD_REGISTER_AGENT, (char *) &req); nếu (!ret)
my_agent = req.id;
- khác
perror(“đăng ký đại lý”);
- Đại lý có thể được hủy đăng ký với IB_USER_MAD_UNREGISTER_AGENT
ioctl. Ngoài ra, tất cả các đại lý được đăng ký thông qua bộ mô tả tệp sẽ không được đăng ký khi bộ mô tả bị đóng.
- 2014
một ioctl đăng ký mới hiện đã được cung cấp cho phép bổ sung các trường sẽ được cung cấp trong quá trình đăng ký. Người dùng cuộc gọi đăng ký này đang ngầm thiết lập việc sử dụng pkey_index (xem bên dưới).
Nhận MAD¶
- MAD được nhận bằng cách sử dụng read(). Bên nhận bây giờ hỗ trợ
RMPP. Bộ đệm được truyền cho read() phải có ít nhất một cấu trúc ib_user_mad + 256 byte. Ví dụ:
- Nếu bộ đệm được truyền không đủ lớn để chứa dữ liệu nhận được
MAD (RMPP), lỗi được đặt thành ENOSPC và độ dài của bộ đệm cần thiết được đặt trong mad.length.
Ví dụ cho MAD bình thường (không phải RMPP) đọc:
- struct ib_user_mad *mad;
điên = malloc(sizeof *mad + 256); ret = read(fd, mad, sizeof *mad + 256); if (ret != sizeof mad + 256) {
perror(“đọc”); tự do (điên);
}
Ví dụ cho RMPP đọc:
- struct ib_user_mad *mad;
điên = malloc(sizeof *mad + 256); ret = read(fd, mad, sizeof *mad + 256); nếu (ret == -ENOSPC)) {
} nếu (ret < 0) {
perror(“đọc”); tự do (điên);
}
- Ngoài nội dung MAD thực tế, cấu trúc khác ib_user_mad
các trường sẽ được điền thông tin về MAD đã nhận. cho ví dụ: LID từ xa sẽ ở dạng mad.lid.
- Nếu quá trình gửi hết thời gian, một lần nhận sẽ được tạo với bộ mad.status
tới ETIMEDOUT. Ngược lại, khi MAD đã được nhận thành công, mad.status sẽ là 0.
poll()/select() có thể được sử dụng để đợi cho đến khi có thể đọc được MAD.
Gửi MAD¶
- MAD được gửi bằng cách sử dụng write(). ID tác nhân để gửi phải là
được điền vào trường id của MAD, LID đích sẽ là điền vào trường nắp, v.v. Bên gửi có hỗ trợ RMPP nên có thể gửi MAD với độ dài tùy ý. Ví dụ:
struct ib_user_mad *mad;
mad = malloc(sizeof *mad + mad_length);
/* điền vào mad->data */
ID giao dịch¶
- Người dùng thiết bị umad có thể sử dụng 32 bit thấp hơn của
trường ID giao dịch (nghĩa là một nửa ít quan trọng nhất của trường theo thứ tự byte mạng) trong MAD được gửi để khớp cặp yêu cầu/phản hồi. 32 bit trên được dành riêng để sử dụng bởi kernel và sẽ bị ghi đè trước khi MAD được gửi.
Xử lý chỉ mục P_Key¶
- Giao diện ib_umad cũ không cho phép thiết lập chỉ mục P_Key cho
MAD được gửi và không cung cấp cách lấy P_Key chỉ số của MAD nhận được. Bố cục mới cho
struct ib_user_mad_hdrvới thành viên pkey_index đã được xác định; tuy nhiên, để bảo toàn nhị phân khả năng tương thích với các ứng dụng cũ hơn, bố cục mới này sẽ không được sử dụng trừ khi một trong các IB_USER_MAD_ENABLE_PKEY hoặc IB_USER_MAD_REGISTER_AGENT2 ioctl được gọi trước khi bộ mô tả tệp được sử dụng cho bất kỳ mục đích nào khác.- Vào tháng 9 năm 2008, IB_USER_MAD_ABI_VERSION sẽ được tăng lên
lên 6, bố cục mới của
struct ib_user_mad_hdrsẽ được sử dụng bởi mặc định và IB_USER_MAD_ENABLE_PKEY ioctl sẽ bị xóa.
Đặt bit khả năng IsSM¶
- Để đặt bit khả năng IsSM cho một cổng, chỉ cần mở
tập tin thiết bị issm tương ứng. Nếu bit IsSM đã được thiết lập, thì lệnh gọi open sẽ chặn cho đến khi bit bị xóa (hoặc trả về ngay lập tức với lỗi được đặt thành EAGAIN nếu cờ O_NONBLOCK là được chuyển tới open()). Bit IsSM sẽ bị xóa khi tệp issm đã đóng cửa. Không thể thực hiện đọc, ghi hoặc các thao tác khác trên tập tin issm.
tập tin /dev¶
- Để tự động tạo các tập tin thiết bị ký tự phù hợp với
udev, một quy tắc như:
- KERNEL==”umad*”, NAME=”infiniband/%k”
KERNEL==”issm*”, NAME=”infiniband/%k”
có thể được sử dụng Điều này sẽ tạo các nút thiết bị có tên:
/dev/infiniband/umad0
/dev/infiniband/issm0
- cho cổng đầu tiên, v.v. Thiết bị và cổng InfiniBand
được liên kết với các thiết bị này có thể được xác định từ các tệp
- /sys/class/infiniband_mad/umad0/ibdev
/sys/class/infiniband_mad/umad0/port
Và:
/sys/class/infiniband_mad/issm0/ibdev
/sys/class/infiniband_mad/issm0/port