sistem · Referensi perintah
qzx inspectPort
Apa fungsinya
Memeriksa apakah port lokal sedang digunakan dan melaporkan proses pemiliknya tanpa menghentikan proses tersebut.
Kematangan perintah: Alpha
Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.
Perilaku dan perlindungan bawaan
Memeriksa tanpa mengubah status
Eksekusi langsung untuk operasi ini
Menggunakan alat native saat diperlukan
Berfungsi tanpa menggunakan jaringan
Menggunakan izin Anda saat ini; hasil dapat bervariasi
inspectPort sepenuhnya hanya-baca dan tidak pernah mengubah status proses.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:c363f820e99c9a68673ff8b09468bcbcd7a3fe7ec1545dcfcfb7d00548ff0994 pada 2026-08-25.
Sintaks persis
qzx inspectPort <port> --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| port | int | Ya | Tidak dideklarasikan | Nomor port yang akan diperiksa |
Contoh input
qzx inspectPort 3000Periksa proses yang mendengarkan pada port 3000 dan dapatkan PID serta waktu pembuatannya
qzx inspectPort 5432 --jsonKembalikan hasil inspeksi lengkap dan terstruktur
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx inspectPort <port> --json
Contoh output representatif
JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.
Perintah contoh: qzx inspectPort 3000 --json
{
"success": true,
"message": "Checks whether a local port is bound and reports the owning process without terminating it. In this illustrative example, the command completed successfully.",
"meta": {
"command": "inspectPort",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 0,
"schema_version": 1
},
"errors": [],
"in_use": "Example value",
"limitations": [
"Example value"
],
"observed_pids": [
3
],
"port": 3,
"processes": [
{
"pid": 4210,
"name": "python",
"cpu_percent": 4.2,
"memory_readable": "82.4 MiB"
}
],
"status": "free"
}Lihat kontrak hasil JSON
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"free",
"in_use"
]
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535
},
"in_use": {
"type": [
"boolean",
"null"
]
},
"observed_pids": {
"type": "array",
"items": {
"type": "integer"
}
},
"processes": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"errors": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
}
},
"additionalProperties": true,
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"meta",
"success"
]
}Kesalahan dan batasan
Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.
QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.
Alur bukti: memerlukan lingkungan privileged yang terkontrol.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/system/inspect_port.py
- Kanal dokumentasi
- Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
- Ketersediaan
- 0.2.2.0.9 atau lebih lama
Lanjut jelajahi
Perintah terkait
Perintah ini juga termasuk kategori sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx helpMenampilkan bantuan untuk sebuah perintah.qzx isAdminMemeriksa apakah pengguna saat ini memiliki hak administratif.qzx getSystemInfoMendapatkan informasi portabel tentang sistem operasi, Python, pengguna, dan lingkungan, dengan detail RAM serta penyimpanan opsional.qzx killProcessMenghentikan proses yang diidentifikasi secara eksplisit dan memastikan proses tersebut telah berakhir.