duc - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

công tước - chỉ mục, truy vấn và biểu đồ sử dụng đĩa

SYNOPSIS

công tước mệnh lệnh phụ lựa chọn

MÔ TẢ

Duc là một tập hợp các công cụ để kiểm tra và hình dung việc sử dụng đĩa.

Duc duy trì một cơ sở dữ liệu được lập chỉ mục về các kích thước tích lũy của các thư mục trong hệ thống tệp của bạn,
và cho phép bạn truy vấn cơ sở dữ liệu này bằng một số công cụ hoặc tạo các biểu đồ sunburst ưa thích để
chỉ cho bạn số byte của bạn ở đâu.

Đức có quy mô khá tốt, nó đã được thử nghiệm trên hệ thống với hơn 500 triệu tệp và
vài petabyte dung lượng lưu trữ.

SỬ DỤNG

Duc đi kèm với một công cụ dòng lệnh có tên là công tước, được sử dụng để tạo, duy trì và truy vấn
cơ sở dữ liệu sử dụng đĩa. chạy công tước giúp đỡ để có được danh sách các lệnh có sẵn. công tước giúp đỡ
mô tả việc sử dụng một lệnh con cụ thể. Chạy công tước giúp đỡ --tất cả các cho một
danh sách mở rộng của tất cả các lệnh và các tùy chọn của chúng.

Duc cho phép bất kỳ tùy chọn nào được đặt trên dòng lệnh hoặc trong tệp cấu hình.
Các tùy chọn trên dòng lệnh được đặt trước dấu gạch ngang kép (--Lựa chọn), một số tùy chọn
có một tùy chọn ngắn tương ứng cũng có thể được sử dụng với một dấu gạch ngang hàng đầu.
(-o)

Khi khởi động duc cố gắng đọc cấu hình của nó từ ba vị trí cụ thể này
gọi món: / etc / ducrc, ~ / .ducrc và .ducrc.

Tệp cấu hình bao gồm các phần và thông số. Tên phần tương ứng với
các lệnh con duc mà các tham số trong phần đó áp dụng. Một phần bắt đầu bằng
tên của phần trong dấu ngoặc vuông và tiếp tục cho đến phần tiếp theo
Bắt đầu. Các phần chứa các tham số, mỗi tham số trên một dòng, bao gồm một tên tùy chọn duy nhất
cho cờ boolean, hoặc tên tùy chọn và giá trị cho các tùy chọn nhận một giá trị. Xem
Phần EXAMPLES để biết ví dụ về định dạng tệp cấu hình.

SÁNG TẠO CÁC INDEX

Duc cần một tệp chỉ mục của hệ thống tệp trước khi nó có thể hiển thị bất kỳ thông tin nào. Đến
tạo chỉ mục, chạy công tước chỉ số chỉ huy. Ví dụ: để tạo chỉ mục về ngôi nhà của bạn
thư mục chạy công tước chỉ số ~

chỉ số $ duc / usr
Bỏ qua bị mất + tìm thấy: Quyền bị từ chối
Đã lập chỉ mục 333823 tệp và 48200 thư mục, (tổng cộng 35.0GB) trong 1 giây

Vị trí mặc định của cơ sở dữ liệu là $ HOME / .duc.db. Để sử dụng một cơ sở dữ liệu khác
vị trí, sử dụng biến môi trường DUC_DATABASE hoặc chỉ định vị trí cơ sở dữ liệu với
đối số --database.

Bạn có thể chạy công tước chỉ số bất kỳ lúc nào sau đó để xây dựng lại chỉ mục.

HỎI CÁC INDEX

Duc có các lệnh con khác nhau để truy vấn hoặc khám phá chỉ mục:

· công tước Thông tin hiển thị danh sách các cây thư mục có sẵn trong cơ sở dữ liệu, thời gian và
ngày của lần quét cuối cùng.

· công tước ls liệt kê tất cả các tệp và thư mục theo đường dẫn nhất định trên bảng điều khiển.

· công tước ui chạy giao diện người dùng bảng điều khiển dựa trên ncurses để khám phá việc sử dụng hệ thống tệp

· công tước gui khởi động giao diện đồ họa (X11) đại diện cho hệ thống tệp trong sunburst
đồ thị. Nhấp vào thư mục để vẽ lại biểu đồ từ góc độ của người đã chọn
danh mục. Nhấp vào giữa biểu đồ để đi lên một thư mục trong cây.

LỰA CHỌN

Phần này liệt kê tất cả các lệnh con có sẵn và mô tả cách sử dụng và các tùy chọn của chúng.

Toàn cầu lựa chọn
Các tùy chọn này áp dụng cho tất cả các lệnh con Duc:

--gỡ lỗi
tăng độ chi tiết lên mức gỡ lỗi

-h, --Cứu giúp
hiển thị trợ giúp

-q, --Yên lặng
chế độ yên tĩnh, không in bất kỳ cảnh báo nào

-v, --dài dòng
tăng độ dài

--phiên bản
thông tin phiên bản và thoát

công tước giúp đỡ
Các tùy chọn cho lệnh công tước giúp đỡ [tùy chọn]:

-a, --tất cả các
hiển thị trợ giúp đầy đủ cho tất cả các lệnh

công tước chỉ số
Lệnh con ´index´ thực hiện quét đệ quy các đường dẫn đã cho trên hệ thống tệp và
tính toán kích thước bao gồm của tất cả các thư mục. Kết quả được ghi vào chỉ mục,
và sau đó có thể được truy vấn bởi một trong các công cụ duc khác.

Các tùy chọn cho lệnh công tước chỉ số [tùy chọn] PATH hữu ích. Cảm ơn !:

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

-d, --database = VAL
sử dụng tệp cơ sở dữ liệu ARG

-e, --exclude = VAL
loại trừ các tệp phù hợp với ARG

-H, --check-hard-liên kết
chỉ đếm các liên kết cứng một lần. nếu hai hoặc nhiều liên kết cứng trỏ đến cùng một tệp, chỉ
một trong những liên kết cứng được hiển thị và đếm

-f, --lực lượng
buộc viết trong trường hợp db bị hỏng

--ẩn tên tập tin
ẩn tên tệp trong chỉ mục (quyền riêng tư). tên của các thư mục sẽ được giữ nguyên, nhưng
tên của các tệp riêng lẻ sẽ bị ẩn

-m, - độ sâu tối đa = VAL
giới hạn tên thư mục ở độ sâu nhất định. khi tùy chọn này được đưa ra, duc sẽ đi ngang qua
hệ thống tệp hoàn chỉnh, nhưng sẽ chỉ cấp VAL đầu tiên của các thư mục trong
cơ sở dữ liệu để giảm kích thước của chỉ mục

-x, --một hệ thống tập tin
bỏ qua các thư mục trên các hệ thống tệp khác nhau

-p, --phát triển
hiển thị tiến trình trong quá trình lập chỉ mục

- không nén
không sử dụng nén cho cơ sở dữ liệu. Duc cho phép nén nếu bên dưới
cơ sở dữ liệu hỗ trợ điều này. Điều này làm giảm kích thước chỉ mục với chi phí dài hơn một chút
thời gian lập chỉ mục

công tước Thông tin
Các tùy chọn cho lệnh công tước Thông tin [tùy chọn]:

-a, --rõ ràng
hiển thị rõ ràng thay vì kích thước tệp thực tế

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

công tước ls
Lệnh con của ´ls 'truy vấn cơ sở dữ liệu duc và liệt kê kích thước bao gồm của tất cả các tệp và
thư mục trên đường dẫn đã cho. Nếu không có đường dẫn nào thì thư mục làm việc hiện tại là
liệt kê.

Các tùy chọn cho lệnh công tước ls [tùy chọn] [CON ĐƯỜNG]:

-a, --rõ ràng
hiển thị rõ ràng thay vì kích thước tệp thực tế

--ascii
sử dụng các ký tự ASCII thay vì UTF-8 để vẽ cây

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

-F, - phân loại
nối chỉ báo loại tệp (một trong số * /) vào các mục nhập

-c, --màu sắc
tô màu đầu ra (chỉ trên ttys)

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

- chỉ dành cho trẻ em
chỉ liệt kê các thư mục, bỏ qua các tệp riêng lẻ

-g, - đồ thị
vẽ biểu đồ với kích thước tương đối cho mỗi mục nhập

-l, --levels = VAL
đi qua các cấp độ ARG sâu [4]

-R, --đệ quy
liệt kê các thư mục con trong chế độ xem dạng cây đệ quy

công tước xml
Các tùy chọn cho lệnh công tước xml [tùy chọn] [CON ĐƯỜNG]:

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

-x, --loại trừ các tập tin
loại trừ tệp khỏi đầu ra xml, chỉ bao gồm các thư mục

-s, --min_size = VAL
chỉ định kích thước tối thiểu cho các tệp hoặc thư mục

công tước cgi
Các tùy chọn cho lệnh công tước cgi [tùy chọn] [CON ĐƯỜNG]:

-a, --rõ ràng
Hiển thị rõ ràng thay vì kích thước tệp thực tế

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

--css-url = VAL
url của CSS style sheet để sử dụng thay vì CSS mặc định

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

--fuzz = VAL
sử dụng hệ số mờ bán kính khi vẽ đồ thị [0.7]

-l, --levels = VAL
kéo sâu đến mức ARG [4]

--danh sách tạo bảng với danh sách tệp

--palette = VAL
chọn bảng màu kích thước | cầu vồng | thang độ xám | đơn sắc

--ring-gap = VAL
để lại khoảng trống VAL pixel giữa các vòng

-s, --size = VAL
kích thước hình ảnh [800]

--chú giải công cụ
bật chú giải công cụ khi di chuột qua biểu đồ. kích hoạt chú giải công cụ sẽ gây ra
yêu cầu HTTP không đồng bộ mỗi khi di chuyển chuột và có thể làm tăng đáng kể
Lưu lượng truy cập HTTP đến máy chủ web

công tước đồ thị
Lệnh con ´graph´ truy vấn cơ sở dữ liệu duc và tạo một biểu đồ sunburst hiển thị
sử dụng đĩa của đường dẫn nhất định. Nếu không có đường dẫn nào được đưa ra, một biểu đồ sẽ được tạo cho hiện tại
thư mục làm việc.

Theo mặc định, biểu đồ được ghi vào tệp ´duc.png´, tệp này có thể được ghi đè bằng cách sử dụng
tùy chọn đầu ra -o / -. Đầu ra có thể được gửi đến stdout bằng cách sử dụng tên tệp đặc biệt
`-`.

Các tùy chọn cho lệnh công tước đồ thị [tùy chọn] [CON ĐƯỜNG]:

-a, --rõ ràng
Hiển thị rõ ràng thay vì kích thước tệp thực tế

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

-f, --format = VAL
chọn định dạng đầu ra png | svg | pdf [png]

--fuzz = VAL
sử dụng hệ số mờ bán kính khi vẽ đồ thị [0.7]

-l, --levels = VAL
kéo sâu đến mức ARG [4]

-o, --output = VAL
tên tệp đầu ra [duc.png]

--palette = VAL
chọn bảng màu kích thước | cầu vồng | thang độ xám | đơn sắc

--ring-gap = VAL
để lại khoảng trống VAL pixel giữa các vòng

-s, --size = VAL
kích thước hình ảnh [800]

công tước gui
Lệnh con ´gui´ truy vấn cơ sở dữ liệu duc và chạy một tiện ích đồ hoạ tương tác
để khám phá việc sử dụng đĩa của đường dẫn đã cho. Nếu không có đường dẫn nào thì hiện tại đang hoạt động
thư mục được khám phá.

Các phím sau có thể được sử dụng để điều hướng và thay đổi biểu đồ:

+ tăng độ sâu đồ thị tối đa
- giảm độ sâu đồ thị tối đa
0 Đặt độ sâu biểu đồ mặc định
a Chuyển đổi giữa mức sử dụng đĩa rõ ràng và thực tế
b Chuyển đổi giữa số lượng byte chính xác và kích thước viết tắt
p chuyển đổi bảng màu
f chuyển đổi đồ thị lông tơ
backspace đi lên một thư mục

Các tùy chọn cho lệnh công tước gui [tùy chọn] [CON ĐƯỜNG]:

-a, --rõ ràng
hiển thị rõ ràng thay vì kích thước tệp thực tế

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

--tối tăm sử dụng màu nền tối

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

--fuzz = VAL
sử dụng hệ số mờ bán kính khi vẽ biểu đồ

-l, --levels = VAL
vẽ sâu đến mức VAL [4]

--palette = VAL
chọn bảng màu kích thước | cầu vồng | thang độ xám | đơn sắc

--ring-gap = VAL
để lại khoảng trống VAL pixel giữa các vòng

công tước ui
Lệnh con ´gui´ truy vấn cơ sở dữ liệu duc và chạy tiện ích ncurses tương tác cho
khám phá việc sử dụng đĩa của đường dẫn đã cho. Nếu không có đường dẫn nào thì hiện tại đang hoạt động
thư mục được khám phá.

Các phím sau có thể được sử dụng để điều hướng và thay đổi hệ thống tệp:

up, pgup, j: di chuyển con trỏ lên
down, pgdn, k: di chuyển con trỏ xuống
left, backspace: đi lên thư mục mẹ (..)
phải, nhập: descent vào thư mục đã chọn
a: chuyển đổi giữa việc sử dụng đĩa thực tế và rõ ràng
b: chuyển đổi giữa kích thước chính xác và kích thước viết tắt
c: chuyển đổi giữa màn hình màu và đơn sắc
g: biểu đồ chuyển đổi
h: hiện sự giúp đỡ. nhấn ´q´ để quay lại màn hình chính
q, Escape: bỏ

Các tùy chọn cho lệnh công tước ui [tùy chọn] [CON ĐƯỜNG]:

-a, --rõ ràng
hiển thị rõ ràng thay vì kích thước tệp thực tế

-b, --byte
hiển thị kích thước tệp theo số byte chính xác

-c, --màu sắc
tô màu đầu ra

-d, --database = VAL
chọn tệp cơ sở dữ liệu để sử dụng [~ / .duc.db]

CGI GIAO DIỆN

Sản phẩm công tước nhị phân có hỗ trợ cho giao diện CGI thô sơ, hiện chỉ được thử nghiệm với
apache. Giao diện CGI tạo một trang HTML đơn giản với danh sách các thư mục được lập chỉ mục,
và hiển thị một biểu đồ có thể nhấp để điều hướng hệ thống tệp. Nếu tùy chọn --danh sách được đưa ra,
một danh sách các tệp / dirs có kích thước hàng đầu cũng được viết.

Cấu hình được thực hiện bằng cách tạo một tập lệnh shell đơn giản dưới dạng .cgi trong một thư mục
được định cấu hình để thực thi CGI bởi máy chủ web của bạn (thường là / usr / lib / cgi-bin). Cái vỏ
script chỉ nên bắt đầu duc và chuyển vị trí của cơ sở dữ liệu để điều hướng.

Một script duc.cgi ví dụ sẽ là

#!/ Bin / sh
/ usr / local / bin / duc cgi -d /home/jenny/.duc.db

· Đảm bảo rằng người dùng có thể đọc được tệp cơ sở dữ liệu (thường là www-data)

· Việc sửa lỗi được thực hiện tốt nhất bằng cách kiểm tra nhật ký lỗi của máy chủ web

· Đảm bảo rằng tập lệnh .cgi có quyền thực thi (chmod +x duc.cgi)

Một số lưu ý:

· Trang HTML được tạo bằng một biểu định kiểu CSS nhúng đơn giản. Nếu phong cách không
theo ý thích của bạn, bạn có thể cung cấp một url CSS bên ngoài với tùy chọn --css-url
sau đó sẽ được sử dụng thay cho định nghĩa kiểu nhúng.

· Thêm tùy chọn --list để tạo một bảng các tệp và thư mục có kích thước hàng đầu trong
Trang HTML.

Cấu hình CGI hiện tại không linh hoạt và cũng không an toàn. Nó không được khuyên để chạy
CGI từ các máy chủ web có thể truy cập công cộng, tự chịu rủi ro khi sử dụng.

A LƯU Ý ON FILE KÍCH THƯỚC VÀ ĐÔ LA SỬ DỤNG

Các khái niệm về "kích thước tệp" và "cách sử dụng đĩa" có thể hơi khó hiểu. Các tệp trên đĩa có một
kích thước biểu kiến, cho biết có bao nhiêu byte trong tệp từ điểm người dùng
quan điểm; đây là kích thước được báo cáo bởi các công cụ như ls -l. Kích thước biểu kiến ​​có thể là bất kỳ số nào,
từ 0 byte đến vài TB. Số byte thực tế được sử dụng trên hệ thống tệp
để lưu trữ tệp có thể khác với kích thước rõ ràng này vì một số lý do:
dữ liệu trong các khối, khiến tệp luôn chiếm nhiều kích thước khối, tệp
có thể có lỗ (tệp ´sparse´) và các lý do kỹ thuật khác. Con số này luôn là một
bội số 512, có nghĩa là kích thước thực tế được sử dụng cho một tệp hầu như luôn luôn là một bit
hơn nữa kích thước rõ ràng của nó.

Duc có hai chế độ để đếm kích thước tệp:

· rõ ràng kích thước: đây là kích thước được báo cáo bởi ls. Con số này cho biết tệp
chiều dài, thường nhỏ hơn mức sử dụng đĩa thực tế.

· thực tế kích thước: đây là kích thước được báo cáo bởi du và df. Kích thước tệp thực tế cho bạn biết
một tệp thực sự sử dụng bao nhiêu đĩa và luôn là bội số của 512 byte.

Chế độ mặc định được duc sử dụng là sử dụng "kích thước thực". Hầu hết các lệnh duc để báo cáo đĩa
sử dụng (công tước ls, công tước đồ thị, công tước gui, v.v.) có một tùy chọn để thay đổi giữa hai chế độ này
(thường là -a), trong công cụ gui, sử dụng phím ´a´ để chuyển đổi.

VÍ DỤ

Lập chỉ mục / usr thư mục, ghi vào vị trí cơ sở dữ liệu mặc định ~ / .duc.db:

chỉ số $ duc / usr

Liệt kê tất cả các tệp và thư mục trong / usr / local, hiển thị kích thước tệp tương đối trong biểu đồ:

$ duc ls -Fg / usr / local
4.7G lib / [++++++++++++++++++++++++++++++++++++++++++++++]
3.1G chia sẻ / [++++++++++++++++++++++++++++++]
2.7G src / [+++++++++++++++++++++++++]
814.9M bin / [+++++++]
196.6 triệu bao gồm / [+]
66.6M x86_64-w64-mingw32 / []
59.9 triệu cục bộ / []
38.8M i686-w64-mingw32 / []
20.3M sbin / []
13.6 triệu lib32 / []
13.3 triệu libx32 / []

hoặc sử dụng các tùy chọn -R cho chế độ xem dạng cây:

$ duc ls -RF / etc / logcheck
24.0K `+ - ignore.d.server /
4.0 nghìn | `+ - hddtemp
4.0 nghìn | | - ntpdate
4.0 nghìn | | - lirc
4.0 nghìn | | - rsyslog
4.0 nghìn | `- libsasl2-module
8.0K | - ignore.d.workstation /
4.0 nghìn | `- lirc
8.0K `- ignore.d.paranoid /
4.0K '- lirc

Khởi động giao diện đồ họa để khám phá hệ thống tệp bằng cách sử dụng đồ thị sunburst:

$ đức quý / usr

Tạo một biểu đồ của / usr / local ở định dạng .png:

$ duc đồ thị -o /tmp/usr.png / usr

Tệp cấu hình mẫu sau xác định các tham số mặc định cho công tước ls và công tước
gui lệnh và xác định một tùy chọn chung để định cấu hình đường dẫn cơ sở dữ liệu được sử dụng bởi
tất cả các lệnh con

[toàn cầu]
cơ sở dữ liệu /var/cache/duc.db

[l]
đệ quy
phân loại
màu sắc

[gui]
lông tơ 0.7
bảng màu cầu vồng
cấp độ 4

[ui]
màu sắc

Sử dụng duc trực tuyến bằng các dịch vụ onworks.net