TÊN
người đàn ông - định dạng và hiển thị các trang hướng dẫn trực tuyến
manpath - xác định đường dẫn tìm kiếm của người dùng cho các trang của người đàn ông
TÓM TẮC
man [ -acdfFhkKtwW ] [ --path ] [ -m hệ thống ] [ -p chuỗi ] [ -C config_file ] [ -M danh sách đường dẫn ] [ -P máy nhắn tin ] [ -S section_list ] [ section ] name ...
SỰ MIÊU TẢ
định dạng con người và hiển thị các trang hướng dẫn trực tuyến. Nếu bạn chỉ định phần , người đàn ông chỉ nhìn vào phần đó của hướng dẫn. tên thường là tên của trang hướng dẫn sử dụng, thường là tên của một lệnh, hàm hoặc tệp. Tuy nhiên, nếu tên có chứa dấu gạch chéo ( / ) thì người đàn ông diễn giải nó dưới dạng đặc tả tệp, để bạn có thể làm người ./foo.5 hoặc thậm chí là man /cd/foo/bar.1.gz .
Xem bên dưới để biết mô tả nơi người đàn ông tìm kiếm các tệp trang thủ công.
TÙY CHỌN
-C config_file
Chỉ định tệp cấu hình để sử dụng; mặc định là /etc/man.config . (Xem man.conf (5).)
Đường dẫn -M
Chỉ định danh sách các thư mục để tìm kiếm các trang hướng dẫn. Tách các thư mục bằng dấu hai chấm. Một danh sách trống giống như không chỉ rõ -M . Xem TÌM KIẾM PATH CHO TRANG TIỂU SỬ .
-P máy nhắn tin
Chỉ định máy nhắn tin nào sẽ sử dụng. Tùy chọn này sẽ ghi đè biến môi trường MANPAGER , nó sẽ ghi đè biến PAGER . Theo mặc định, người dùng sử dụng / usr / bin / less -isr .
-S section_list
Danh sách là danh sách các phần thủ công được phân tách bằng dấu hai chấm để tìm kiếm. Tùy chọn này sẽ ghi đè biến môi trường MANSECT .
-a
Theo mặc định, người đàn ông sẽ thoát ra sau khi hiển thị trang hướng dẫn đầu tiên mà nó tìm thấy. Sử dụng tùy chọn này buộc người dùng phải hiển thị tất cả các trang thủ công khớp với tên, không chỉ là trang đầu tiên.
-c
Định dạng lại trang nguồn gốc, ngay cả khi trang mèo cập nhật tồn tại. Điều này có thể có ý nghĩa nếu trang cat được định dạng cho màn hình có số lượng cột khác nhau hoặc nếu trang được định dạng trước bị hỏng.
-d
Không thực sự hiển thị các trang của người đàn ông, nhưng in các thông tin gỡ lỗi.
-D
Cả thông tin gỡ lỗi in và hiển thị.
-f
Tương đương với whatis .
-F hoặc --preformat
Chỉ định dạng - không hiển thị.
-h
In tin nhắn trợ giúp một dòng và thoát.
-k
Tương đương với apropos .
-K
Tìm kiếm chuỗi được chỉ định trong các trang * tất cả * người. Cảnh báo: điều này có lẽ rất chậm! Nó giúp xác định một phần. (Chỉ để đưa ra một ý tưởng thô, trên máy của tôi, điều này mất khoảng một phút cho mỗi 500 trang người đàn ông.)
-m hệ thống
Chỉ định một tập hợp các trang con người thay thế để tìm kiếm dựa trên tên hệ thống đã cho.
-p chuỗi
Chỉ định trình tự của các bộ tiền xử lý để chạy trước nroff hoặc troff . Không phải tất cả các cài đặt sẽ có một bộ tiền xử lý đầy đủ. Một số tiền xử lý và các chữ cái được sử dụng để chỉ định chúng là: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), tham khảo (r). Tùy chọn này sẽ ghi đè biến môi trường MANROFFSEQ .
-t
Sử dụng / usr / bin / groff -Tps -mandoc để định dạng trang thủ công, chuyển đầu ra sang chế độ xuất chuẩn. Đầu ra từ / usr / bin / groff -Tps -mandoc có thể cần phải được truyền qua một số bộ lọc hoặc bộ lọc khác trước khi được in.
-w hoặc --path
Không thực sự hiển thị các trang của người đàn ông, nhưng hãy in (các) vị trí của các tệp sẽ được định dạng hoặc hiển thị. Nếu không có đối số được đưa ra: hiển thị (trên stdout) danh sách các thư mục được tìm kiếm bởi người đàn ông cho các trang người đàn ông. Nếu manpath là một liên kết đến con người, thì "manpath" tương đương với "man --path".
-W
Giống như -w, nhưng in tên tệp trên một dòng, không có thông tin bổ sung. Điều này rất hữu ích trong các lệnh shell như man -aW man | xargs ls -l
TRANG CAT
Người đàn ông sẽ cố gắng lưu các trang người đàn ông được định dạng, để tiết kiệm thời gian định dạng trong lần tiếp theo các trang này là cần thiết. Theo truyền thống, các phiên bản được định dạng của các trang trong DIR / manX được lưu trong DIR / catX, nhưng các ánh xạ khác từ thư mục man đến cat dir có thể được xác định trong /etc/man.config . Không có trang mèo nào được lưu khi thư mục cat bắt buộc không tồn tại. Không có trang cat nào được lưu khi chúng được định dạng cho độ dài dòng khác với 80. Không có trang cat nào được lưu khi man.conf chứa dòng NOCACHE.
Nó có thể làm cho người đàn ông suid đến một người sử dụng. Sau đó, nếu thư mục con mèo có chủ sở hữu và chế độ 0755 (chỉ có thể ghi bởi con người) và tệp cat có chủ sở hữu và chế độ 0644 hoặc 0444 (chỉ có thể ghi được bởi người đàn ông hoặc không thể ghi), không người dùng bình thường nào có thể thay đổi trang cat hoặc đặt các tệp khác trong thư mục con mèo. Nếu người đàn ông không được làm suid, sau đó một thư mục con mèo nên có chế độ 0777 nếu tất cả người dùng sẽ có thể để lại các trang con mèo ở đó.
Tùy chọn -c buộc định dạng lại một trang, ngay cả khi trang mèo gần đây tồn tại.
TÌM KIẾM PATH CHO PAGES MANUAL
người dùng sử dụng một phương pháp phức tạp để tìm kiếm các tệp trang thủ công, dựa trên các tùy chọn gọi và các biến môi trường, tệp cấu hình /etc/man.config và một số quy ước và phỏng đoán được xây dựng.
Trước hết, khi đối số tên cho con người chứa dấu gạch chéo ( / ), người đàn ông giả định nó là một đặc tả tệp chính nó, và không có tìm kiếm nào liên quan.
Nhưng trong trường hợp bình thường, nơi tên không chứa dấu gạch chéo, người đàn ông tìm kiếm nhiều thư mục khác nhau cho một tệp có thể là trang thủ công cho chủ đề có tên.
Nếu bạn chỉ định tùy chọn- pathlist- M , danh sách đường dẫn là danh sách các thư mục mà người đó tìm kiếm.
Nếu bạn không chỉ định -M nhưng thiết lập biến môi trường MANPATH , giá trị của biến đó là danh sách các thư mục mà người đàn ông tìm kiếm.
Nếu bạn không chỉ định một danh sách đường dẫn rõ ràng với -M hoặc MANPATH , man phát triển danh sách đường dẫn riêng của nó dựa trên nội dung của tệp cấu hình /etc/man.config . Các câu lệnh MANPATH trong tệp cấu hình xác định các thư mục cụ thể để bao gồm trong đường dẫn tìm kiếm.
Hơn nữa, các câu lệnh MANPATH_MAP thêm vào đường dẫn tìm kiếm tùy thuộc vào đường dẫn tìm kiếm lệnh của bạn (tức là biến môi trường PATH của bạn). Đối với mỗi thư mục có thể nằm trong đường dẫn tìm kiếm lệnh, một câu lệnh MANPATH_MAP chỉ định thư mục cần được thêm vào đường dẫn tìm kiếm cho các tệp trang thủ công. người đàn ông nhìn vào biến PATH và thêm các thư mục tương ứng vào đường dẫn tìm kiếm tệp thủ công. Do đó, với việc sử dụng đúng MANPATH_MAP , khi bạn đưa ra lệnh man xyz , bạn sẽ nhận được một trang hướng dẫn sử dụng cho chương trình sẽ chạy nếu bạn đã ban hành lệnh xyz .
Ngoài ra, đối với mỗi thư mục trong đường dẫn tìm kiếm lệnh (chúng tôi sẽ gọi nó là "thư mục lệnh") mà bạn không có câu lệnh MANPATH_MAP , người dùng sẽ tự động tìm thư mục trang thủ công "lân cận" cụ thể là thư mục con trong thư mục lệnh chính nó hoặc trong thư mục cha của thư mục lệnh.
Bạn có thể vô hiệu hóa các tìm kiếm "lân cận" tự động bằng cách bao gồm câu lệnh NOAUTOPATH trong /etc/man.config .
Trong mỗi thư mục trong đường dẫn tìm kiếm như được mô tả ở trên, người dùng tìm kiếm một tệp có tên là chủ đề . , với hậu tố tùy chọn trên số phần và có thể là hậu tố nén. Nếu nó không tìm thấy một tập tin như vậy, nó sẽ tìm trong bất kỳ thư mục con nào có tên là man N hoặc cat N trong đó N là số phần của thủ công. Nếu tệp nằm trong thư mục con mèo N , người đàn ông giả định tệp đó là tệp trang thủ công được định dạng (trang con mèo). Nếu không, người đàn ông giả định nó không được định dạng. Trong cả hai trường hợp, nếu tên tệp có hậu tố nén đã biết (như .gz ), thì người đàn ông giả định rằng nó được nén.
Nếu bạn muốn xem nơi (hoặc nếu) người đàn ông sẽ tìm thấy trang hướng dẫn sử dụng cho một chủ đề cụ thể, sử dụng tùy chọn --path ( -w ).
Quan trọng: Sử dụng lệnh man ( % man ) để xem cách một lệnh được sử dụng trên máy tính cụ thể của bạn.