CLI রেফারেন্স

ternux CLI হলো স্থায়ী ব্যবস্থাপনা ইন্টারফেস — ইনস্টল, ডায়াগনস্টিক, মেরামত, বেঞ্চমার্ক, ডেস্কটপ লাইফসাইকেল ও সিস্টেম তথ্যের জন্য।

এই reference $PREFIX/bin/ternux-এ installed পূর্ণ Termux host command-এর। Debian/Xfce terminal-এ আলাদা guest-aware /usr/local/bin/ternux companion আছে; এটি শুধু status, info, doctor (verify একই কাজের alias), env, --version ও help দেয়। Nested PRoot না খুলে host lifecycle command প্রত্যাখ্যান করে। নিচের host commandগুলো Termux-এ চালান। Installer command দুটি execute ও version-check করে; শুধু file presence-কে successful CLI installation ধরা হয় না।

ব্যবহার

ternux <command> [options] [subcommand]

গ্লোবাল ফ্ল্যাগ

Dispatcher command load করার আগে global flag চিনে, তাই command-এর আগে বা পরে দেওয়া যায়। কিন্তু সব command JSON schema দেয় না। install, live logs tail বা uninstall-এ --json দিয়ে structured output আশা করবেন না; নিচে JSON উদাহরণ আছে এমন command-এই ব্যবহার করুন। ওই path-গুলোর stdout একটি parseable JSON object, এবং backend value canonical zink বা virgl; পুরোনো zink-turnip শুধু compatibility input/state হিসেবে accepted। Shared dispatch/environment failure-এ command: "error", status: "fatal" ও message থাকে; unknown command-এ requested_command-ও থাকে। lib/core.sh load হওয়ার আগের failure JSON বানাতে পারে না, তাই সেটি plain stderr।

কমান্ডসমূহ

ternux install

সম্পূর্ণ ternux ডেস্কটপ ইনস্টল বা পুনরায় ইনস্টল।

ternux install [options]

ternux start

Xfce4 ডেস্কটপ সেশন চালু করে।

ternux start

ternux stop

ডেস্কটপ সেশন বন্ধ করে সকেট পরিষ্কার করে।

ternux stop

ternux restart

ডেস্কটপ পুনরায় চালু করে (stop + ১ সেকেন্ড + start)।

ternux restart

ternux doctor

সম্পূর্ণ সিস্টেম ডায়াগনস্টিক চালায়।

ternux doctor [--json]

ternux repair

ছয় ধাপে common issue inspect/repair করে:

1. broken curl/OpenSSL host toolchain;
2. missing termux-x11-nightly;
3. configured backend apply, stored SHA-256 অনুযায়ী missing/changed Turnip target reinstall, এবং launcher backend alignment;
4. missing বা syntax-broken launcher regeneration;
5. populated Mesa shader cache clear;
6. missing PulseAudio TCP bridge add।

Healthy check repair count-এ যোগ হয় না। যেকোনো step fail হলে অন্য step চলতে পারে, কিন্তু শেষ status non-zero হয়। Backend/launcher repair-এর পর desktop restart করে renderer আবার verify করুন।

ternux repair

ternux verify

ইনস্টলেশন সম্পূর্ণতা যাচাই করে। যাচাই ব্যর্থ হলে human এবং --json—দুই mode-এই nonzero exit status দেয়।

ternux verify [--json]

ternux benchmark

Active desktop-এ Debian container-এর ভেতর glmark2/vkmark health benchmark এবং renderer inspection চালায়। Renderer classification llvmpipe, Zink/Turnip, plain Zink, বা VirGL/virpipe route আলাদা করে; শুধু VirGL নাম hardware-backed route প্রমাণ করে না। এটি archived evidence run-এর identical protocol নয়।

ternux benchmark [--json]

ternux profile

ডিভাইস প্রোফাইলিং ও ব্যবস্থাপনা।

ternux profile <subcommand> [name]

ternux backend

GPU ব্যাকএন্ড ব্যবস্থাপনা।

ternux backend <subcommand> [backend]

ternux info

সিস্টেম তথ্য সারসংক্ষেপ।

ternux info [--json]

ternux state

ইনস্টলেশন অবস্থা দেখান।

ternux state [--json]

ternux logs

লগ ফাইল দেখা ও ব্যবস্থাপনা।

ternux logs <subcommand> [n]

ternux update

ternux CLI আপডেট।

ternux update [check]

ternux uninstall

Scoped component removal। Action না দিলে interactive menu; non-interactive shell-এ action অবশ্যই explicit দিন।

ternux uninstall [session|launcher|state|container|all] [--yes]

• session / 1 — desktop service stop ও stale socket cleanup
• launcher / 2 — ~/x.sh এবং delimited shell-alias block remove
• state / 3 — ternux state/log remove; Debian অক্ষত
• container / 4 — Debian ও তার ভেতরের সব data delete
• all / 5 — উপরের চারটি action
• 0 — cancel

all Termux package বা ternux CLI/library uninstall, storage access revoke, mirror reset বা Termux PulseAudio configuration revert করে না। Container deletion confirmation চায়। Automation-এ irreversible data loss ইচ্ছাকৃতভাবে accept করলেই শুধু --yes দিন।

শেল কমপ্লিশন

Bash কমপ্লিশন উপলব্ধ share/ternux-completion.bash-এ:

source share/ternux-completion.bash

এনভায়রনমেন্ট ভেরিয়েবল

নিচের প্রতিটি ভেরিয়েবল শুরুতেই পড়া হয়; কমান্ড-লাইন ফ্ল্যাগ সবসময় অগ্রাধিকার পায়।

পূর্ণ বিবরণ: কনফিগারেশন → ইনস্টলার আউটপুট।

আর্কিটেকচার

bin/ternux          ← thin command/flag dispatcher
lib/core.sh         ← শেয়ার্ড I/O, JSON বিল্ডার, স্টেট, লগিং
lib/help.sh         ← সেন্ট্রালাইজড হেল্প
lib/detect.sh       ← ডিভাইস ডিটেকশন
lib/desktop.sh      ← ডেস্কটপ লাইফসাইকেল
lib/doctor.sh       ← ডায়াগনস্টিক + ভেরিফিকেশন
lib/info.sh         ← সিস্টেম তথ্য
lib/backend.sh      ← GPU ব্যাকএন্ড
lib/profile.sh      ← ডিভাইস প্রোফাইলিং
lib/benchmark.sh    ← GPU benchmark ও renderer classification
lib/repair.sh       ← validated phase দিয়ে repair engine
lib/logs.sh         ← লগ ব্যবস্থাপনা
lib/update.sh       ← সেলফ-আপডেট
lib/state.sh        ← installation state
lib/uninstall.sh    ← scoped, confirmed component removal
lib/phases.sh       ← ইনস্টলেশন implementation (১১টি ধাপ)
lib/ui.sh           ← ইনস্টলার রেন্ডারার: dashboard, plain frame, log stream

নতুন কমান্ড যোগ করা:

1. lib/<name>.sh তৈরি করুন tnx_cmd_<name>() ফাংশন দিয়ে
2. lib/help.sh-এ tnx_help_<name>() যোগ করুন
3. শেষ — ডিসপ্যাচার স্বয়ংক্রিয় শনাক্ত করে

ternux — সর্বস্বত্ব (c) ২০২৬ Sobuj Miah (@soobujmiah) · Apache-2.0 লাইসেন্স