Document new -P functionality

[ldid.git] / docs / ldid.zh_TW.1

diff --git a/docs/ldid.zh_TW.1 b/docs/ldid.zh_TW.1
index 909cc06489ac99c16fe20791c15aced5a5a52770..d675d19260e077abc8ed405516a5b1db95e0c031 100644 (file)
--- a/docs/ldid.zh_TW.1
+++ b/docs/ldid.zh_TW.1
@@ -1,5 +1,5 @@
 .\"-
 .\"-

-.\" Copyright (c) 2021-2022 ProcursusTeam
+.\" Copyright (c) 2021-2022 Procursus Team <team@procurs.us>

 .\" SPDX-License-Identifier: AGPL-3.0-or-later
 .\"
 .Dd January 20, 2022
 .\" SPDX-License-Identifier: AGPL-3.0-or-later
 .\"
 .Dd January 20, 2022


@@ -10,41 +10,56 @@
 .Nd 鏈接身份編輯器
 .Sh 語法
 .Nm
 .Nd 鏈接身份編輯器
 .Sh 語法
 .Nm

-.Op Fl A Ns Ar cputype : Ns Ar subtype
+.Op Fl A Ns Ar 處理器類型 : Ns Ar 亞類型

 .Op Fl a
 .Op Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
 .Op Fl D
 .Op Fl d
 .Op Fl E Ns Ar 數字 : Ns Ar 檔案
 .Op Fl e
 .Op Fl a
 .Op Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
 .Op Fl D
 .Op Fl d
 .Op Fl E Ns Ar 數字 : Ns Ar 檔案
 .Op Fl e

+.Op Fl H Ns Op Ar sha1 | Ar sha256

 .Op Fl h
 .Op Fl h

-.Op Fl K Ns Ar key.p12 Op Fl U Ns Ar password
+.Op Fl I Ns Ar 名稱
+.Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密碼

 .Op Fl M
 .Op Fl P
 .Op Fl M
 .Op Fl P

+.Op Fl Q Ns Ar 需求

 .Op Fl q
 .Op Fl r | Fl S Ns Ar 檔案.xml | Fl s
 .Op Fl q
 .Op Fl r | Fl S Ns Ar 檔案.xml | Fl s

-.Op Fl T Ns Ar timestamp

 .Op Fl u
 .Op Fl u

+.Op Fl arch Ar 架構類型

 .Ar
 .Sh 描述
 .Nm
 .Ar
 .Sh 描述
 .Nm

-把SHA1和SHA256雜湊值加入到Mach-O檔案中，讓它們能在有驗證但沒有簽署驗證的系統上運行。
+把SHA1和SHA256雜湊值加入到Mach-O檔案中，
+讓它們能在有驗證但沒有簽署驗證的系統上運行。

 .Bl -tag -width -indent
 .Bl -tag -width -indent

-.It Fl a
-以十六進制印出處理器類型和亞類型。
-.It Fl A Ns Ar cputype : Ns Ar subtype
+.It Fl A Ns Ar 處理器類型 : Ns Ar 亞類型

 當和
 .Fl a , Fl D , Fl e , Fl h , Fl q ,
 或
 .Fl u ,
 一起被使用時，只作用在被
 當和
 .Fl a , Fl D , Fl e , Fl h , Fl q ,
 或
 .Fl u ,
 一起被使用時，只作用在被

-.Ar cputype
+.Ar 處理器類型

 和
 和

-.Ar subtype .
-.Ar cputype
+.Ar 亞類型
+指定的部分。
+.Ar 處理器類型
+和
+.Ar 亞類型
+都應該是整數。
+.It Fl a
+以十六進制印出處理器類型和亞類型。
+.It Fl arch Ar 架構類型

 和
 和

-.Ar subtype
-指定的部分。它們都應該是整數。
+.Fl A
+一樣，不過使用架構的名稱。
+已知的
+.Ar 架構類型 Ns s
+可以在
+.Xr arch 3
+中找到。
+這是一個Procursus擴展。

 .It Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
 設定要在檔案中包含的程式碼簽署選項。
 請看
 .It Fl C Ns Op Ar adhoc | Ar enforcement | Ar expires | Ar hard | Ar host | Ar kill | Ar library-validation | Ar restrict | Ar runtime
 設定要在檔案中包含的程式碼簽署選項。
 請看


@@ -54,9 +69,6 @@
 重設加密碼 (cryptid)。
 .It Fl d
 輸出在二進位檔案中的加密碼。
 重設加密碼 (cryptid)。
 .It Fl d
 輸出在二進位檔案中的加密碼。

-由於兼容性原因，這也能作為
-.Fl h ,
-工作，但在將來這會被移除。

 .It Fl E Ns Ar 數字 : Ns Ar 檔案
 將
 .Ar 檔案
 .It Fl E Ns Ar 數字 : Ns Ar 檔案
 將
 .Ar 檔案


@@ -68,28 +80,37 @@
 .Fl A ,
 所指定的部分的權限
 .Ar 到標準輸出。
 .Fl A ,
 所指定的部分的權限
 .Ar 到標準輸出。

+.It Fl H Ns Op Ar sha1 | Ar sha256
+禁用沒有指明的雜湊嗎。
+這個選項可以用來重現
+.Xr codesign 1
+只提供sha256簽署的預設行為。

 .It Fl h
 印出關於簽署的資訊，包括雜湊值的
 類型，選項，CDHash, 和 CodeDirectory 版本到
 .Ar 標準輸出。
 .It Fl h
 印出關於簽署的資訊，包括雜湊值的
 類型，選項，CDHash, 和 CodeDirectory 版本到
 .Ar 標準輸出。

-.It Fl K Ns Ar key.p12
+.It Fl I Ns Ar 名稱
+把二進制檔案簽署中的識別碼設定為
+.Ar 名稱。
+如沒有指明，就會使用二進位檔案的檔案名稱。
+.It Fl K Ns Ar 密錀.p12

 用在
 用在

-.Ar key.p12 .
-的身份簽署。這會給二進位檔案有一個有效的簽署，令它能夠在有簽署驗證的系統上運行。
+.Ar 密錀.p12 .
+的身份簽署。會給二進位檔案有一個有效的簽署，令它能夠在有簽署驗證的系統上運行。

 如果
 如果

-.Ar key.p12
-æ\9c\89å¯\86碼ç\9a\84話ï¼\8cä½ æ\9c\83被詢å\95\8fã\80\82ä½ ä¹\9få\8f¯ä»¥ç\94¨
-.Fl U .
-.Ar 選項來提供密碼。 .
+.Ar 密錀.p12
+有密碼的話，你會被詢問。也可以用
+.Fl U
+選項來提供密碼。

 .It Fl M
 當和
 .Fl S ,
 .It Fl M
 當和
 .Fl S ,

-一起使用時，和現有的權限合併而不是取代它。 這在加入權限時有用。
+一起使用時，和現有的權限合併而不是取代它。在加入權限時有用。

 .It Fl P
 將這個Mach-O二進位檔案標示為系統二進位檔案。
 .It Fl P
 將這個Mach-O二進位檔案標示為系統二進位檔案。

-.It Fl Q Ns Ar 檔案
+.It Fl Q Ns Ar 需求

 把需求嵌入到
 把需求嵌入到

-.Ar 檔案 .
+.Ar 需求

 中。
 .It Fl q
 印出被嵌入在二進位檔案中的需求。
 中。
 .It Fl q
 印出被嵌入在二進位檔案中的需求。


@@ -104,19 +125,11 @@
 中的權限會被嵌入到Mach-O中。
 .It Fl s
 重新簽署Mach-O檔案但保留現有權限。
 中的權限會被嵌入到Mach-O中。
 .It Fl s
 重新簽署Mach-O檔案但保留現有權限。

-.It Fl T Ns Ar 時間印章
-當簽署一個動態鏈結函式庫時，把時間印章設定為
-.Ar 時間印章 .
-.Ar 時間印章
-應該是一個以秒作為單位的UNIX時間印章，如果
-.Ar
-是一個連字號的話
-.Pq Sq Fl ,
-時間印章會被設定為Mach-O頭中的時間印章。

 .It Fl U Ns Ar 密碼
 使用
 .Ar 密碼
 作為p12證書的密碼，而不是詢問。
 .It Fl U Ns Ar 密碼
 使用
 .Ar 密碼
 作為p12證書的密碼，而不是詢問。

+這是一個Procursus擴展。

 .It Fl u
 如果Mach-O檔案有和UIKit鏈結，印出被鏈結的UIKit版本。
 .El
 .It Fl u
 如果Mach-O檔案有和UIKit鏈結，印出被鏈結的UIKit版本。
 .El


@@ -131,15 +144,15 @@
 .Pp
 指令：
 .Pp
 .Pp
 指令：
 .Pp

-.Dl "ldid -Cadhoc -K/path/to/key.p12 -Sent.xml 檔案"
+.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 檔案"

 .Pp
 會使用
 .Pp
 會使用

-.Ar /path/to/key.p12
+.Ar /path/to/密錀.p12

 中的私錀來簽署
 .Ar 檔案
 也會使用在
 .Ar ent.xml ,
 中的私錀來簽署
 .Ar 檔案
 也會使用在
 .Ar ent.xml ,

-中的權限並把簽署標示為特別用途 (adhoc) 簽署。.
+中的權限並把簽署標示為特別用途 (adhoc) 簽署。

 .Pp
 指令:
 .Pp
 .Pp
 指令:
 .Pp


@@ -168,7 +181,7 @@
 .An Jay \*qSaurik\*q Freeman . 所編寫的。
 對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
 .Fl S
 .An Jay \*qSaurik\*q Freeman . 所編寫的。
 對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
 .Fl S

-在2008年6月13日被加入。.
+在2008年6月13日被加入。

 SHA256 支援在2016年8月25日被加入，修正iOS 11支援。
 iOS 14支援在2020年7月31日由
 .An Kabir Oberai .
 SHA256 支援在2016年8月25日被加入，修正iOS 11支援。
 iOS 14支援在2020年7月31日由
 .An Kabir Oberai .