người đàn ông - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

man - một giao diện cho các hướng dẫn tham khảo trực tuyến

SYNOPSIS

người đàn ông [-C hồ sơ] [-d] [-D] [- cảnh báo[=cảnh báo]] [-R mã hóa] [-L miền địa phương] [-m
hệ thống[, ...]] [-M con đường] [-S ] [-e mở rộng] [-i|-I] [--regex|--ký tự đại diện]
[- chỉ tên] [-a] [-u] [- không có trang con] [-P máy nhắn tin] [-r nhanh chóng] [-7] [-E mã hóa]
[- không có gạch nối] [- không biện minh] [-p chuỗi] [-t] [-T[thiết bị]] [-H[trình duyệt]]
[-X[dpi]] [-Z] [ [phần] trang ...] ...
người đàn ông -k [thích hợp lựa chọn] regexp hữu ích. Cảm ơn !
người đàn ông -K [-w|-W] [-S ] [-i|-I] [--regex] [phần] kỳ hạn hữu ích. Cảm ơn !
người đàn ông -f [những gì là lựa chọn] trang hữu ích. Cảm ơn !
người đàn ông -l [-C hồ sơ] [-d] [-D] [- cảnh báo[=cảnh báo]] [-R mã hóa] [-L miền địa phương] [-P máy nhắn tin]
[-r nhanh chóng] [-7] [-E mã hóa] [-p chuỗi] [-t] [-T[thiết bị]] [-H[trình duyệt]] [-X[dpi]] [-Z]
hồ sơ hữu ích. Cảm ơn !
người đàn ông -w|-W [-C hồ sơ] [-d] [-D] trang hữu ích. Cảm ơn !
người đàn ông -c [-C hồ sơ] [-d] [-D] trang hữu ích. Cảm ơn !
người đàn ông [-? V]

MÔ TẢ

người đàn ông là máy nhắn tin thủ công của hệ thống. Mỗi trang đối số đưa ra cho người đàn ông thường là tên của
một chương trình, tiện ích hoặc chức năng. Các nhãn hiệu trang được liên kết với mỗi đối số này
sau đó được tìm thấy và hiển thị. MỘT phần, nếu được cung cấp, sẽ chỉ đạo người đàn ông chỉ nhìn vào đó
phần của sách hướng dẫn. Hành động mặc định là tìm kiếm trong tất cả các phần
theo thứ tự được xác định trước ("1 nl 8 3 2 3posix 3pm 3perl 5 4 9 6 7" theo mặc định, trừ khi
bị ghi đè bởi PHẦN chỉ thị trong /etc/manpath.config), và chỉ hiển thị đầu tiên
trang tìm thấy, ngay cả khi trang tồn tại trong một số phần.

Bảng dưới đây cho thấy phần số của sách hướng dẫn sau đó là các loại trang
chúng chứa đựng.

1 Các chương trình thực thi hoặc các lệnh shell
2 Lệnh gọi hệ thống (các chức năng do hạt nhân cung cấp)
3 Lệnh gọi thư viện (các chức năng trong thư viện chương trình)
4 Tệp đặc biệt (thường được tìm thấy trong / dev)
5 Định dạng tệp và quy ước, ví dụ: / etc / passwd
6 Games
7 Các điều khoản khác (bao gồm các gói và quy ước macro), ví dụ: người đàn ông(7) sự lộn xộn(7)
8 Lệnh quản trị hệ thống (thường chỉ dành cho root)
9 quy trình hạt nhân [Không chuẩn]

Hướng dẫn sử dụng trang bao gồm một số phần.

Tên phần thông thường bao gồm TÊN, SYNOPSIS, CẤU HÌNH, MÔ TẢ, LỰA CHỌN,
EXIT TÌNH TRẠNG, TRỞ VỀ VALUE , LRI, MÔI TRƯỜNG, CÁC TẬP TIN, PHIÊN BẢN, CẤU TẠO ĐẾN, GHI CHÚ,
GIỎI, THÍ DỤ, TÁC GIẢvà XEM CŨNG THẾ.

Các quy ước sau áp dụng cho SYNOPSIS và có thể được sử dụng như một hướng dẫn trong
các phần khác.

đậm văn bản gõ chính xác như hình.
nghiêng văn bản thay thế bằng lập luận thích hợp.
[-abc] bất kỳ hoặc tất cả các đối số trong [] là tùy chọn.
-a|-b các tùy chọn được giới hạn bởi | không thể được sử dụng cùng nhau.
đối số hữu ích. Cảm ơn ! đối số có thể lặp lại.
[biểu hiện] ... toàn bộ biểu hiện trong [] có thể lặp lại.

Kết xuất chính xác có thể khác nhau tùy thuộc vào thiết bị đầu ra. Ví dụ, người đàn ông thường sẽ
không thể hiển thị chữ nghiêng khi chạy trong một thiết bị đầu cuối và thường sẽ sử dụng
thay vào đó, gạch chân hoặc văn bản có màu.

Lệnh hoặc hình minh họa hàm là một mẫu phù hợp với tất cả những gì có thể
lời kêu gọi. Trong một số trường hợp, bạn nên minh họa một số lời gọi độc quyền như
được hiển thị trong SYNOPSIS phần của trang hướng dẫn này.

VÍ DỤ

người đàn ông ls
Hiển thị trang hướng dẫn sử dụng cho mục (chương trình) ls.

người đàn ông -a intro
Hiển thị, nối tiếp nhau, tất cả những thứ có sẵn intro các trang thủ công có trong
thủ công. Có thể thoát giữa các màn hình kế tiếp hoặc bỏ qua bất kỳ màn hình nào.

người đàn ông -t bí danh | lpr -ppp
Định dạng trang thủ công được tham chiếu bởi `bí danh', thường là một trang hướng dẫn sử dụng shell, vào
mặc định troff or sự lộn xộn định dạng và chuyển nó đến máy in có tên ps. Đầu ra mặc định
cho sự lộn xộn thường là PostScript. người đàn ông --Cứu giúp nên cho biết bộ xử lý nào là
ràng buộc với -t tùy chọn.

người đàn ông -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Lệnh này sẽ giải nén và định dạng trang hướng dẫn sử dụng nguồn nroff ./foo.1x.gz trong
a thiết bị độc lập (đvi) tập tin. Việc chuyển hướng là cần thiết vì -T cờ nguyên nhân
đầu ra được hướng đến tiêu chuẩn không có máy nhắn tin. Đầu ra có thể được xem với
chương trình chẳng hạn như xdvi hoặc tiếp tục được xử lý thành PostScript bằng cách sử dụng một chương trình như
dvip.

người đàn ông -k printf
Tìm kiếm các mô tả ngắn và tên trang thủ công cho từ khóa printf như thường lệ
biểu hiện. In ra bất kỳ kết quả phù hợp nào. Tương đương với thích hợp printf.

người đàn ông -f Chửi mắng
Tra cứu các trang thủ công được tham chiếu bởi Chửi mắng và in ra các mô tả ngắn về
bất kỳ tìm thấy. Tương đương với những gì là Chửi mắng.

TỔNG QUAN

Nhiều tùy chọn có sẵn cho người đàn ông để mang lại sự linh hoạt nhiều nhất có thể cho
người dùng. Các thay đổi có thể được thực hiện đối với đường dẫn tìm kiếm, thứ tự phần, bộ xử lý đầu ra và các
các hành vi và hoạt động được trình bày chi tiết bên dưới.

Nếu được đặt, các biến môi trường khác nhau sẽ được thẩm vấn để xác định hoạt động của người đàn ông.
Có thể đặt biến $ bắt tất cảMANOPT đến bất kỳ chuỗi nào trong dòng lệnh
định dạng với ngoại lệ là bất kỳ khoảng trắng nào được sử dụng như một phần của đối số của tùy chọn phải là
đã thoát (trước dấu gạch chéo ngược). người đàn ông sẽ phân tích cú pháp $MANOPT trước khi phân tích cú pháp của chính nó
dòng lệnh. Các tùy chọn yêu cầu đối số đó sẽ bị ghi đè bởi các tùy chọn tương tự
tìm thấy trên dòng lệnh. Để đặt lại tất cả các tùy chọn được đặt trong $MANOPT, -D có thể
được chỉ định làm tùy chọn dòng lệnh ban đầu. Điều này sẽ cho phép con người `` quên '' về
các tùy chọn được chỉ định bằng $MANOPT mặc dù chúng vẫn phải có giá trị.

Các tiện ích máy nhắn tin thủ công được đóng gói dưới dạng man-db sử dụng rộng rãi chỉ số bộ nhớ đệm cơ sở dữ liệu.
Các bộ nhớ đệm này chứa thông tin như nơi có thể tìm thấy mỗi trang thủ công trên
hệ thống tập tin và những gì nó những gì là (mô tả ngắn một dòng của trang người đàn ông) chứa, và
cho phép người đàn ông để chạy nhanh hơn nếu nó phải tìm kiếm hệ thống tệp mỗi lần để tìm
trang hướng dẫn thích hợp. Nếu được yêu cầu bằng cách sử dụng -u Tùy chọn, người đàn ông sẽ đảm bảo rằng
bộ nhớ đệm vẫn nhất quán, điều này có thể loại bỏ nhu cầu chạy phần mềm theo cách thủ công để cập nhật
truyền thống những gì là cơ sở dữ liệu văn bản.

If người đàn ông không thể tìm thấy một mandb khởi xướng chỉ số cơ sở dữ liệu cho một trang hướng dẫn cụ thể
phân cấp, nó vẫn sẽ tìm kiếm các trang thủ công được yêu cầu, mặc dù tệp tin
sẽ cần thiết để tìm kiếm trong hệ thống phân cấp đó. Nếu như những gì là or thích hợp không tìm thấy một
chỉ số nó sẽ cố gắng trích xuất thông tin từ một những gì là cơ sở dữ liệu thay thế.

Các tiện ích này hỗ trợ các tệp nroff nguồn nén, theo mặc định, có phần mở rộng
of .Z, .z và .gz. Có thể xử lý bất kỳ phần mở rộng nén nào, nhưng điều này
thông tin phải được biết tại thời điểm biên dịch. Ngoài ra, theo mặc định, bất kỳ trang mèo nào được tạo đều
nén bằng cách sử dụng gzip. Mỗi hệ thống phân cấp trang thủ công `` toàn cầu '' như / usr / share / man or
/ usr / X11R6 / man có thể có bất kỳ thư mục nào dưới dạng phân cấp trang mèo của nó. Theo truyền thống, con mèo
các trang được lưu trữ theo cùng một hệ thống phân cấp như các trang nam, nhưng vì những lý do như
được chỉ định trong Tập tin Hệ thống cấp bậc Tiêu chuẩn (FHS), có thể tốt hơn nếu lưu trữ chúng ở nơi khác.
Để biết chi tiết về cách thực hiện việc này, vui lòng đọc con đường đàn ông(5). Để biết chi tiết về lý do tại sao phải làm điều này,
đọc tiêu chuẩn.

Hỗ trợ quốc tế có sẵn với gói này. Các trang hướng dẫn sử dụng ngôn ngữ bản địa là
có thể truy cập (nếu có trên hệ thống của bạn) thông qua việc sử dụng miền địa phương chức năng. Để kích hoạt như vậy
hỗ trợ, cần phải đặt $LC_MESSAGES, $NGÔN NGỮ hoặc một hệ thống khác phụ thuộc
biến môi trường đối với ngôn ngữ địa phương của bạn, thường được chỉ định trong POSIX 1003.1 dựa
định dạng:

<Ngôn ngữ>[_<lãnh thổ>[.<bộ ký tự>[,<phiên bản>]]]

Nếu trang mong muốn có sẵn trong miền địa phương, nó sẽ được hiển thị thay cho
trang tiêu chuẩn (thường là tiếng Anh Mỹ).

Hỗ trợ cho danh mục tin nhắn quốc tế cũng được đặc trưng trong gói này và có thể
được kích hoạt theo cách tương tự, một lần nữa nếu có. Nếu bạn thấy rằng các trang hướng dẫn sử dụng và
danh mục tin nhắn được cung cấp cùng với gói này không có sẵn bằng ngôn ngữ mẹ đẻ của bạn
và bạn muốn cung cấp chúng, vui lòng liên hệ với người bảo trì, người sẽ điều phối
hoạt động như vậy.

Để biết thông tin về các tính năng và tiện ích mở rộng khác có sẵn với máy nhắn tin thủ công này,
vui lòng đọc các tài liệu được cung cấp cùng với gói.

ĐỊNH NGHĨA

người đàn ông sẽ tìm kiếm các trang thủ công mong muốn trong chỉ số bộ nhớ đệm cơ sở dữ liệu. Nếu -u
tùy chọn được đưa ra, kiểm tra tính nhất quán của bộ đệm được thực hiện để đảm bảo cơ sở dữ liệu chính xác
phản ánh hệ thống tập tin. Nếu tùy chọn này luôn được đưa ra, nói chung không cần thiết phải
chạy mandb sau khi bộ đệm được tạo ban đầu, trừ khi bộ đệm bị hỏng.
Tuy nhiên, việc kiểm tra tính nhất quán của bộ đệm có thể bị chậm trên các hệ thống có nhiều trang thủ công
được cài đặt, vì vậy nó không được thực hiện theo mặc định và quản trị viên hệ thống có thể muốn chạy
mandb hàng tuần hoặc lâu hơn để giữ cho bộ nhớ cache của cơ sở dữ liệu luôn mới. Để ngăn chặn các vấn đề do
bộ nhớ đệm lỗi thời, người đàn ông sẽ quay trở lại tập tin hiển thị nếu tra cứu bộ nhớ cache không thành công, giống như nó
sẽ nếu không có bộ nhớ cache.

Khi đã định vị được trang hướng dẫn sử dụng, việc kiểm tra sẽ được thực hiện để tìm xem người thân
tệp `cat 'được định dạng sẵn đã tồn tại và mới hơn tệp nroff. Nếu nó có và
là, tệp được định dạng sẵn này (thường) được giải nén và sau đó được hiển thị, thông qua việc sử dụng
máy nhắn tin. Máy nhắn tin có thể được chỉ định theo một số cách hoặc nếu không sẽ quay trở lại
mặc định được sử dụng (xem tùy chọn -P để biết chi tiết). Nếu không tìm thấy con mèo nào hoặc lớn hơn
tệp nroff, nroff được lọc qua các chương trình khác nhau và được hiển thị ngay lập tức.

Nếu tệp mèo có thể được tạo (tồn tại một thư mục mèo tương đối và có
quyền), người đàn ông sẽ nén và lưu trữ tệp mèo ở chế độ nền.

Các bộ lọc được giải mã bằng một số phương tiện. Đầu tiên, tùy chọn dòng lệnh -p or
biến môi trường $MANROFFSEQ bị thẩm vấn. Nếu như -p không được sử dụng và
biến môi trường không được đặt, dòng đầu tiên của tệp nroff được phân tích cú pháp cho một
chuỗi tiền xử lý. Để chứa một chuỗi tiền xử lý hợp lệ, dòng đầu tiên phải giống

'\ " <chuỗi>

Ở đâu chuỗi có thể là bất kỳ sự kết hợp nào của các chữ cái được mô tả theo tùy chọn -p phía dưới.

Nếu không có phương pháp nào ở trên cung cấp bất kỳ thông tin bộ lọc nào, thì một tập hợp mặc định sẽ được sử dụng.

Một đường dẫn định dạng được hình thành từ các bộ lọc và bộ định dạng chính (ăn trộm or
[tg]sự đùa giỡn với -t) và được thực thi. Ngoài ra, nếu một chương trình thực thi mandb_nfmt (Hoặc
mandb_tfmt với -t) tồn tại trong gốc cây đàn ông, nó được thực thi thay thế. Nó được thông qua
tệp nguồn thủ công, chuỗi tiền xử lý và tùy chọn thiết bị được chỉ định với
-T or -E như các đối số.

LỰA CHỌN

Các tùy chọn không đối số được sao chép trên dòng lệnh, trong $MANOPT, hoặc cả hai,
không có hại. Đối với các tùy chọn yêu cầu đối số, mỗi bản sao sẽ ghi đè lên
giá trị đối số trước đó.

Tổng Quát lựa chọn
-C hồ sơ, --config-file =hồ sơ
Sử dụng tệp cấu hình người dùng này thay vì tệp mặc định của ~ / .manpath.

-d, --gỡ lỗi
In thông tin gỡ lỗi.

-D, --vỡ nợ
Tùy chọn này thường được phát hành dưới dạng tùy chọn đầu tiên và đặt lại của đàn ông hành vi
theo mặc định của nó. Công dụng của nó là đặt lại những tùy chọn có thể đã được đặt trong
$MANOPT. Bất kỳ tùy chọn nào theo sau -D sẽ có tác dụng bình thường của chúng.

- cảnh báo[=cảnh báo]
Bật cảnh báo từ sự lộn xộn. Điều này có thể được sử dụng để thực hiện kiểm tra sự tỉnh táo trên
văn bản nguồn của các trang hướng dẫn sử dụng. cảnh báo là danh sách các tên cảnh báo được phân tách bằng dấu phẩy;
nếu nó không được cung cấp, mặc định là "mac". Xem nút "Cảnh báo" trong Thông tin sự lộn xộn
để biết danh sách các tên cảnh báo có sẵn.

Chủ yếu chế độ of hoạt động
-f, --là gì
Tương đương với những gì là. Hiển thị một mô tả ngắn từ trang hướng dẫn sử dụng, nếu
có sẵn. Nhìn thấy những gì là(1) để biết chi tiết.

-k, --đề nghị
Tương đương với thích hợp. Tìm kiếm các mô tả trang thủ công ngắn cho các từ khóa và
hiển thị bất kỳ kết quả phù hợp nào. Nhìn thấy thích hợp(1) để biết chi tiết.

-K, --global-apropos
Tìm kiếm văn bản trong tất cả các trang thủ công. Đây là một tìm kiếm thô bạo và có khả năng
để mất một thời gian; nếu có thể, bạn nên chỉ định một phần để giảm số lượng
các trang cần được tìm kiếm. Cụm từ tìm kiếm có thể là các chuỗi đơn giản (mặc định),
hoặc biểu thức chính quy nếu --regex tùy chọn được sử dụng.

-l, --local-tệp
Kích hoạt chế độ `` cục bộ ''. Định dạng và hiển thị các tệp thủ công cục bộ thay vì tìm kiếm
thông qua bộ sưu tập thủ công của hệ thống. Mỗi đối số trang thủ công sẽ là
được hiểu là một tệp nguồn nroff ở định dạng chính xác. Không có tệp mèo nào là
được sản xuất. Nếu '-' được liệt kê là một trong các đối số, đầu vào sẽ được lấy từ
stdin. Khi tùy chọn này không được sử dụng và người đàn ông không tìm thấy trang được yêu cầu,
trước khi hiển thị thông báo lỗi, nó cố gắng hoạt động như thể tùy chọn này
được cung cấp, sử dụng tên làm tên tệp và tìm kiếm kết hợp chính xác.

-w, --ở đâu, --con đường, --vị trí
Không thực sự hiển thị các trang thủ công, nhưng hãy in (các) vị trí của nguồn
nroff các tệp sẽ được định dạng.

-W, - mèo ở đâu, --location-cat
Không thực sự hiển thị các trang hướng dẫn sử dụng, nhưng hãy in (các) vị trí của con mèo
các tệp sẽ được hiển thị. Nếu -w và -W đều được chỉ định, hãy in cả hai
cách nhau một khoảng trắng.

-c, --người mèo
Tùy chọn này không dành cho mục đích sử dụng chung và chỉ nên được sử dụng bởi người mèo chương trình.

-R mã hóa, --recode=mã hóa
Thay vì định dạng trang thủ công theo cách thông thường, hãy xuất nguồn của nó đã được chuyển đổi
với quy định mã hóa. Nếu bạn đã biết mã hóa của tệp nguồn,
bạn cũng có thể dùng manconv(1) trực tiếp. Tuy nhiên, tùy chọn này cho phép bạn chuyển đổi
một số trang thủ công cho một mã hóa duy nhất mà không cần phải trình bày rõ ràng
mã hóa của mỗi loại, miễn là chúng đã được cài đặt trong một cấu trúc tương tự
sang hệ thống phân cấp trang thủ công.

Tìm kiếm nhãn hiệu trang
-L miền địa phương, --locale =miền địa phương
người đàn ông thông thường sẽ xác định ngôn ngữ hiện tại của bạn bằng cách gọi hàm C
định vị(3) thẩm vấn các biến môi trường khác nhau, có thể bao gồm
$LC_MESSAGES và $NGÔN NGỮ. Để tạm thời ghi đè giá trị đã xác định, hãy sử dụng
tùy chọn để cung cấp một miền địa phương chuỗi trực tiếp đến người đàn ông. Lưu ý rằng nó sẽ không mất
có hiệu lực cho đến khi quá trình tìm kiếm các trang thực sự bắt đầu. Đầu ra chẳng hạn như thông báo trợ giúp
sẽ luôn được hiển thị trong ngôn ngữ được xác định ban đầu.

-m hệ thống[, ...], --systems =hệ thống[, ...]
Nếu hệ thống này có quyền truy cập vào các trang hướng dẫn sử dụng hệ điều hành khác, chúng có thể
được truy cập bằng cách sử dụng tùy chọn này. Để tìm kiếm trang hướng dẫn từ trang hướng dẫn của NewOS
bộ sưu tập, sử dụng tùy chọn -m hệ điều hành mới.

Sản phẩm hệ thống được chỉ định có thể là sự kết hợp của hệ điều hành được phân tách bằng dấu phẩy
những cái tên. Để bao gồm tìm kiếm các trang thủ công của hệ điều hành gốc, hãy bao gồm
tên hệ thống người đàn ông trong chuỗi đối số. Tùy chọn này sẽ ghi đè $WELFARE
biến môi trường.

-M con đường, --manpath =con đường
Chỉ định một đường dẫn thay thế để sử dụng. Theo mặc định, người đàn ông sử dụng con đường đàn ông mã dẫn xuất đến
xác định đường đi để tìm kiếm. Tùy chọn này ghi đè $CON ĐƯỜNG môi trường
tùy chọn biến và nguyên nhân -m được bỏ qua.

Đường dẫn được chỉ định làm đường dẫn phải là gốc của hệ thống phân cấp trang thủ công
được cấu trúc thành các phần như được mô tả trong hướng dẫn sử dụng man-db (trong "Trang hướng dẫn sử dụng
hệ thống "). Để xem các trang thủ công bên ngoài hệ thống phân cấp như vậy, hãy xem -l tùy chọn.

-S , -s , --section =
Danh sách là danh sách được phân tách bằng dấu hai chấm hoặc dấu phẩy gồm các phần thủ công `` theo thứ tự cụ thể '' để
Tìm kiếm. Tùy chọn này ghi đè $MANSECT biến môi trường. (Các -s chính tả
là để tương thích với Hệ thống V.)

-e phần mở rộng phụ, --extension =phần mở rộng phụ
Một số hệ thống kết hợp các gói lớn các trang thủ công, chẳng hạn như những
đi cùng Tcl gói, vào hệ thống phân cấp trang thủ công chính. Để đi xung quanh
vấn đề có hai trang thủ công có cùng tên, chẳng hạn như ra(3), Tcl
tất cả các trang thường được gán cho phần l. Vì điều này là không may, nó là bây giờ
có thể đặt các trang vào đúng phần và chỉ định một
`` mở rộng '' cho họ, trong trường hợp này, ra(3tcl). Đang hoạt động bình thường, người đàn ông sẽ
trưng bày ra(3) ưu tiên ra(3tcl). Để thương lượng tình huống này và
tránh phải biết trang bạn yêu cầu nằm ở phần nào, nó bây giờ là
có thể cho người đàn ông a phần mở rộng phụ chuỗi cho biết gói trang nào phải
thuộc về. Sử dụng ví dụ trên, cung cấp tùy chọn -e TCL đến người đàn ông sẽ
hạn chế tìm kiếm đối với các trang có phần mở rộng là * tcl.

-i, --bỏ qua trường hợp
Bỏ qua trường hợp khi tìm kiếm các trang thủ công. Đây là mặc định.

-I, - trường hợp phù hợp
Tìm kiếm các trang thủ công phân biệt chữ hoa chữ thường.

--regex
Hiển thị tất cả các trang có bất kỳ phần nào của tên hoặc mô tả của chúng trùng khớp
mỗi trang đối số như một biểu thức chính quy, như với thích hợp(1). Vì có
thường không có cách hợp lý nào để chọn một trang "tốt nhất" khi tìm kiếm
biểu thức, tùy chọn này ngụ ý -a.

--ký tự đại diện
Hiển thị tất cả các trang có bất kỳ phần nào của tên hoặc mô tả của chúng trùng khớp
mỗi trang đối số bằng cách sử dụng các ký tự đại diện kiểu shell, như với thích hợp(1) --ký tự đại diện. Các
trang đối số phải khớp với toàn bộ tên hoặc mô tả hoặc khớp với từ
ranh giới trong mô tả. Vì thường không có cách hợp lý để chọn một
trang "tốt nhất" khi tìm kiếm ký tự đại diện, tùy chọn này ngụ ý -a.

- chỉ tên
Nếu --regex or --ký tự đại diện tùy chọn được sử dụng, chỉ khớp với tên trang, không khớp với trang
mô tả, như với những gì là(1). Nếu không, không có hiệu lực.

-a, --tất cả các
Theo mặc định, người đàn ông sẽ thoát ra sau khi hiển thị trang hướng dẫn phù hợp nhất mà nó tìm thấy.
Sử dụng tùy chọn này buộc người đàn ông để hiển thị tất cả các trang thủ công có tên phù hợp
tiêu chí tìm kiếm.

-u, - cập nhật
Tùy chọn này gây ra người đàn ông để thực hiện kiểm tra tính nhất quán của cấp độ inode
bộ nhớ đệm cơ sở dữ liệu để đảm bảo rằng chúng là đại diện chính xác của
hệ thống tập tin. Nó sẽ chỉ có tác dụng hữu ích nếu người đàn ông được cài đặt với setuid
bộ bit.

- không có trang con
Theo mặc định, người đàn ông sẽ cố gắng giải thích các cặp tên trang thủ công được đưa ra trên
dòng lệnh tương đương với một tên trang thủ công có chứa dấu gạch ngang hoặc dấu
gạch dưới. Điều này hỗ trợ mô hình chung của các chương trình triển khai một số
của các lệnh con, cho phép chúng cung cấp các trang thủ công cho mỗi lệnh có thể được truy cập
sử dụng cú pháp tương tự như sẽ được sử dụng để gọi chính các lệnh con. Vì
thí dụ:

$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz

Để vô hiệu hóa hành vi này, hãy sử dụng - không có trang con tùy chọn.

$ man -aw --no-trang con git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz

Kiểm soát được định dạng đầu ra
-P máy nhắn tin, --pager =máy nhắn tin
Chỉ định máy nhắn tin đầu ra sẽ sử dụng. Theo mặc định, người đàn ông sử dụng máy nhắn tin. Tùy chọn này
ghi đè $QUẢN LÝ biến môi trường, đến lượt nó sẽ ghi đè $PAGER
biến môi trường. Nó không được sử dụng cùng với -f or -k.

Giá trị có thể là một tên lệnh đơn giản hoặc một lệnh có các đối số và có thể sử dụng
trích dẫn shell (dấu gạch chéo ngược, dấu nháy đơn hoặc dấu nháy kép). Nó có thể không sử dụng đường ống
để kết nối nhiều lệnh; nếu bạn cần, hãy sử dụng tập lệnh trình bao bọc, có thể
lấy tệp để hiển thị dưới dạng đối số hoặc trên đầu vào chuẩn.

-r nhanh chóng, --prompt =nhanh chóng
Nếu một phiên bản gần đây của ít được sử dụng làm máy nhắn tin, người đàn ông sẽ cố gắng thiết lập nó
nhắc nhở và một số tùy chọn hợp lý. Lời nhắc mặc định trông giống như

Hướng dẫn sử dụng trang tên(giây) hàng x

Ở đâu tên biểu thị tên trang thủ công, giây biểu thị phần nó được tìm thấy dưới
và x số dòng hiện tại. Điều này đạt được bằng cách sử dụng $ÍT HƠN môi trường
biến.

Cung cấp -r với một chuỗi sẽ ghi đè mặc định này. Chuỗi có thể chứa
văn bản $ MAN_PN sẽ được mở rộng thành tên của trang hướng dẫn hiện tại và
tên phần được bao quanh bởi dấu `('và`)'. Chuỗi được sử dụng để tạo ra giá trị mặc định
có thể được diễn đạt như

\ Thủ công\ trang\ \ $ MAN_PN \ ? ltline \ % lt? L /% L.:
byte \ % bB? s /% s ..? \ (HẾT):? PB \ % pB \\% ..
(nhấn h cho giúp đỡ or q đến từ bỏ)

Nó được chia thành ba dòng ở đây chỉ nhằm mục đích dễ đọc. Cho mình
nghĩa là xem ít(1) trang hướng dẫn sử dụng. Chuỗi lời nhắc đầu tiên được đánh giá bởi
vỏ bọc. Tất cả các dấu ngoặc kép, dấu ngoặc kép và dấu gạch chéo ngược trong lời nhắc phải là
thoát ra bởi một dấu gạch chéo ngược trước đó. Chuỗi lời nhắc có thể kết thúc bằng $ thoát ra
có thể được theo sau bởi các tùy chọn khác với chi phí thấp hơn. Theo mặc định người đàn ông thiết lập -ix8 tùy chọn.

$KHÔNG CÓ CON NGƯỜI biến môi trường được mô tả bên dưới có thể được sử dụng để đặt mặc định
chuỗi dấu nhắc nếu không có chuỗi nào được cung cấp trên dòng lệnh.

-7, --ascii
Khi xem một tinh khiết ascii(7) trang hướng dẫn sử dụng thiết bị đầu cuối 7 bit hoặc trình giả lập đầu cuối,
một số ký tự có thể không hiển thị chính xác khi sử dụng latin1(7) thiết bị
mô tả với GNU ăn trộm. Tùy chọn này cho phép ascii trang hướng dẫn sử dụng
hiển thị trong ascii với latin1 thiết bị. Nó sẽ không dịch bất kỳ latin1 văn bản.
Bảng sau đây cho thấy các bản dịch được thực hiện: một số phần của nó có thể chỉ
hiển thị đúng cách khi sử dụng GNU ăn trộm's latin1(7) thiết bị.

Mô tả Octal latin1 ascii
────────────────────────────────
gạch nối tiếp tục 255 - -
dấu đầu dòng (chấm giữa) 267 · o
giọng cấp tính 264 ´ '
dấu nhân 327 × x

Nếu latin1 cột hiển thị chính xác, thiết bị đầu cuối của bạn có thể được thiết lập cho latin1
ký tự và tùy chọn này là không cần thiết. Nếu latin1 và ascii cột là
giống hệt nhau, bạn đang đọc trang này bằng cách sử dụng tùy chọn này hoặc người đàn ông không định dạng cái này
trang sử dụng latin1 Mô tả thiết bị. Nếu latin1 cột bị thiếu hoặc
bị hỏng, bạn có thể cần xem các trang thủ công với tùy chọn này.

Tùy chọn này bị bỏ qua khi sử dụng các tùy chọn -t, -H, -T, hoặc là -Z và có thể vô ích cho
ăn trộm khác hơn GNU's.

-E mã hóa, - mã hóa=mã hóa
Tạo đầu ra cho mã hóa ký tự khác với mã hóa mặc định. Cho lùi
khả năng tương thích, mã hóa có thể là một ăn trộm thiết bị chẳng hạn như ascii, latin1, hoặc là utf8 as
cũng như mã hóa ký tự thực, chẳng hạn như UTF-8.

- không có gạch nối, --nh
Thông thường, ăn trộm sẽ tự động gạch nối văn bản tại các dấu ngắt dòng ngay cả trong các từ
không chứa dấu gạch nối, nếu cần thiết phải làm như vậy để sắp xếp các từ trên một dòng
không có khoảng cách quá mức. Tùy chọn này tắt tự động gạch nối, vì vậy các từ
sẽ chỉ được gạch nối nếu chúng đã chứa dấu gạch nối.

Nếu bạn đang viết một trang thủ công và chỉ muốn ngăn chặn ăn trộm từ gạch nối
một từ ở điểm không thích hợp, không sử dụng tùy chọn này, nhưng hãy tham khảo ăn trộm
tài liệu thay thế; ví dụ: bạn có thể đặt "\%" bên trong một từ để biểu thị
nó có thể được gạch nối tại thời điểm đó hoặc đặt "\%" ở đầu một từ để
ngăn nó được gạch nối.

- không biện minh, --nj
Thông thường, ăn trộm sẽ tự động căn chỉnh văn bản sang cả hai lề. Tùy chọn này
vô hiệu hóa sự biện minh đầy đủ, đôi khi chỉ để điều chỉnh hợp lý sang lề bên trái
được gọi là văn bản "tả tơi".

Nếu bạn đang viết một trang thủ công và chỉ muốn ngăn chặn ăn trộm khỏi biện minh
một số đoạn văn, không sử dụng tùy chọn này, nhưng hãy tham khảo ăn trộm tài liệu hướng dẫn
thay thế; ví dụ: bạn có thể sử dụng các yêu cầu ".na", ".nf", ".fi" và ".ad" để
tạm thời vô hiệu hóa điều chỉnh và điền.

-p chuỗi, --preprocessor =chuỗi
Chỉ định trình tự các bộ tiền xử lý sẽ chạy trước đó ăn trộm or troff/sự lộn xộn. Không phải tất cả
cài đặt sẽ có một bộ tiền xử lý đầy đủ. Một số bộ tiền xử lý và
các chữ cái được sử dụng để chỉ định chúng là: tương đương (e), grap (g), một chút (p), tbl (t), vgrind
(v), xem (r). Tùy chọn này ghi đè $MANROFFSEQ biến môi trường.
zsoelim luôn chạy với tư cách là bộ tiền xử lý đầu tiên.

-t, --troff
Sử dụng sự lộn xộn -mandoc để định dạng trang thủ công thành stdout. Tùy chọn này không bắt buộc
kết hợp với -H, -T, hoặc là -Z.

-T[thiết bị], --troff-thiết bị[=thiết bị]
Tùy chọn này được sử dụng để thay đổi sự lộn xộn (hoặc có thể troff's) đầu ra phù hợp với
một thiết bị khác với thiết bị mặc định. Nó ngụ ý -t. Ví dụ (được cung cấp với
Groff-1.17) bao gồm dvi, latin1, ps, utf8, X75 và X100.

-H[trình duyệt], --html[=trình duyệt]
Tùy chọn này sẽ gây ra sự lộn xộn để tạo ra đầu ra HTML và sẽ hiển thị đầu ra đó
trong trình duyệt web. Việc lựa chọn trình duyệt được xác định bởi tùy chọn trình duyệt
nếu một đối số được cung cấp, bởi $TRÌNH DUYỆT biến môi trường, hoặc bởi một biên dịch-
thời gian mặc định nếu điều đó không được đặt (thường là Linh miêu). Tùy chọn này ngụ ý -t, và sẽ
chỉ làm việc với GNU troff.

-X[dpi], --gxditview[=dpi]
Tùy chọn này hiển thị đầu ra của sự lộn xộn trong một cửa sổ đồ họa bằng cách sử dụng gxditview
chương trình. Các dpi (chấm trên inch) có thể là 75, 75-12, 100 hoặc 100-12, mặc định là
75; các biến thể -12 sử dụng phông chữ cơ sở 12 điểm. Tùy chọn này ngụ ý -T với
Thiết bị X75, X75-12, X100 hoặc X100-12 tương ứng.

-Z, --ditroff
sự lộn xộn sẽ chạy troff và sau đó sử dụng một bộ xử lý hậu kỳ thích hợp để tạo ra đầu ra
phù hợp với thiết bị đã chọn. Nếu như sự lộn xộn -mandoc is sự lộn xộn, tùy chọn này được thông qua
đến sự lộn xộn và sẽ ngăn chặn việc sử dụng bộ xử lý hậu kỳ. Nó ngụ ý -t.

Bắt giúp đỡ
-?, --Cứu giúp
In thông báo trợ giúp và thoát.

--sử dụng
In một tin nhắn sử dụng ngắn và thoát.

-V, --phiên bản
Hiển thị thông tin phiên bản.

EXIT TÌNH TRẠNG

0 Thực hiện chương trình thành công.

1 Lỗi sử dụng, cú pháp hoặc tệp cấu hình.

2 Lỗi hoạt động.

3 Một tiến trình con trả về trạng thái thoát khác XNUMX.

16 Ít nhất một trong các trang / tệp / từ khóa không tồn tại hoặc không được đối sánh.

MÔI TRƯỜNG

CON ĐƯỜNG
Nếu $CON ĐƯỜNG được đặt, giá trị của nó được sử dụng làm đường dẫn để tìm kiếm các trang thủ công.

MANROOFFOPT
Nội dung của $MANROOFFOPT được thêm vào dòng lệnh mọi lúc người đàn ông viện dẫn
định dạng (ăn trộm, troff, hoặc là sự lộn xộn).

MANROFFSEQ
Nếu $MANROFFSEQ được đặt, giá trị của nó được sử dụng để xác định bộ tiền xử lý để
vượt qua từng trang hướng dẫn sử dụng. Danh sách bộ tiền xử lý mặc định phụ thuộc vào hệ thống.

MANSECT
Nếu $MANSECT được đặt, giá trị của nó là danh sách các phần được phân tách bằng dấu hai chấm và nó được sử dụng
để xác định các phần thủ công cần tìm kiếm và theo thứ tự. Giá trị mặc định là "1
nl 8 3 2 3posix 3pm 3perl 5 4 9 6 7 ", trừ khi bị ghi đè bởi PHẦN Chỉ thị
in /etc/manpath.config.

QUẢN LÝ, PAGER
Nếu $QUẢN LÝ hoặc $PAGER được thiết lập ($QUẢN LÝ được sử dụng theo sở thích), giá trị của nó được sử dụng
như tên của chương trình được sử dụng để hiển thị trang hướng dẫn sử dụng. Theo mặc định, máy nhắn tin is
đã sử dụng.

Giá trị có thể là một tên lệnh đơn giản hoặc một lệnh có các đối số và có thể sử dụng
trích dẫn shell (dấu gạch chéo ngược, dấu nháy đơn hoặc dấu nháy kép). Nó có thể không sử dụng đường ống
để kết nối nhiều lệnh; nếu bạn cần, hãy sử dụng tập lệnh trình bao bọc, có thể
lấy tệp để hiển thị dưới dạng đối số hoặc trên đầu vào chuẩn.

KHÔNG CÓ CON NGƯỜI
Nếu $KHÔNG CÓ CON NGƯỜI được đặt, giá trị của nó sẽ được sử dụng làm chuỗi nhắc mặc định cho
ít máy nhắn tin, như thể nó đã được chuyển bằng cách sử dụng -r tùy chọn (vì vậy bất kỳ lần xuất hiện nào của
văn bản $ MAN_PN sẽ được mở rộng theo cách tương tự). Ví dụ: nếu bạn muốn đặt
chuỗi lời nhắc vô điều kiện thành “chuỗi lời nhắc của tôi”, đặt $KHÔNG CÓ CON NGƯỜI đến
'-Psmy nhanh chóng chuỗi'. Sử dụng -r tùy chọn ghi đè biến môi trường này.

TRÌNH DUYỆT
Nếu $TRÌNH DUYỆT được đặt, giá trị của nó là một danh sách các lệnh được phân tách bằng dấu hai chấm, mỗi lệnh trong số đó
đến lượt nó được sử dụng để cố gắng khởi động một trình duyệt web cho người đàn ông --html. Trong mỗi lệnh, %s
được thay thế bằng tên tệp chứa đầu ra HTML từ sự lộn xộn, %% được thay thế bởi
một dấu phần trăm duy nhất (%) và %c được thay thế bằng dấu hai chấm (:).

WELFARE Nếu $WELFARE được đặt, nó sẽ có tác dụng giống như thể nó đã được chỉ định là
đối số với -m tùy chọn.

MANOPT Nếu $MANOPT được thiết lập, nó sẽ được phân tích cú pháp trước của đàn ông dòng lệnh và dự kiến ​​sẽ
ở một định dạng tương tự. Như tất cả những thứ khác người đàn ông các biến môi trường cụ thể có thể
được thể hiện dưới dạng các tùy chọn dòng lệnh và do đó là ứng cử viên để được đưa vào
$MANOPT người ta cho rằng chúng sẽ trở nên lỗi thời. NB Tất cả các khoảng trắng
nên được hiểu là một phần của đối số của tùy chọn phải được thoát.

BĂNG TỘC
Nếu $BĂNG TỘC được đặt, giá trị của nó được sử dụng làm độ dài dòng cho các trang thủ công
nên được định dạng. Nếu nó không được đặt, các trang thủ công sẽ được định dạng bằng một dòng
độ dài phù hợp với thiết bị đầu cuối hiện tại (sử dụng giá trị $CỘT, An
ioctls(2) nếu có, hoặc lùi xuống 80 ký tự nếu không có).
Các trang mèo sẽ chỉ được lưu khi có thể sử dụng định dạng mặc định, đó là khi
độ dài dòng cuối từ 66 đến 80 ký tự.

MAN_KEEP_FORMATTING
Thông thường, khi đầu ra không được chuyển hướng đến một thiết bị đầu cuối (chẳng hạn như tệp hoặc
pipe), các ký tự định dạng bị loại bỏ để giúp đọc kết quả dễ dàng hơn
mà không cần các công cụ đặc biệt. Tuy nhiên, nếu $MAN_KEEP_FORMATTING được đặt thành bất kỳ trống nào
giá trị, các ký tự định dạng này được giữ lại. Điều này có thể hữu ích cho trình bao bọc
xung quanh người đàn ông có thể diễn giải các ký tự định dạng.

MAN_KEEP_STDERR
Thông thường, khi đầu ra được hướng đến một thiết bị đầu cuối (thường là đến một máy nhắn tin), bất kỳ
lỗi đầu ra từ lệnh được sử dụng để tạo ra các phiên bản được định dạng của các trang thủ công là
bị loại bỏ để tránh ảnh hưởng đến hiển thị của máy nhắn tin. Các chương trình như sự lộn xộn
thường tạo ra các thông báo lỗi tương đối nhỏ về các vấn đề đánh máy, chẳng hạn như
căn chỉnh kém, khó coi và thường gây nhầm lẫn khi hiển thị dọc theo
với trang hướng dẫn sử dụng. Tuy nhiên, một số người dùng vẫn muốn xem chúng, vì vậy, nếu
$MAN_KEEP_STDERR được đặt thành bất kỳ giá trị không trống nào, đầu ra lỗi sẽ được hiển thị dưới dạng
bình thường.

NGÔN NGỮ, LC_MESSAGES
Tùy thuộc vào hệ thống và cách triển khai, một trong hai hoặc cả haiNGÔN NGỮ và $LC_MESSAGES
sẽ được thẩm vấn về ngôn ngữ tin nhắn hiện tại. người đàn ông sẽ hiển thị tin nhắn của nó
trong ngôn ngữ đó (nếu có). Nhìn thấy định vị(3) để biết chi tiết chính xác.

Sử dụng người đàn ông trực tuyến bằng các dịch vụ onworks.net