aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNick Chan <towinchenmi@gmail.com>2022-07-23 08:10:00 +0800
committerGitHub <noreply@github.com>2022-07-22 20:10:00 -0400
commitc62968304976748c7671fd3a56d255e5cad5b291 (patch)
tree30513aad421eb0de890bdb5e7815eaa294413258
parente605d49a6079a2852e60115d5003d243ec0cd51d (diff)
downloadldid-c62968304976748c7671fd3a56d255e5cad5b291.tar.gz
ldid-c62968304976748c7671fd3a56d255e5cad5b291.tar.zst
ldid-c62968304976748c7671fd3a56d255e5cad5b291.zip
Manpage updates (#19)
* ldid.zh_TW.1, ldid.zh_CN.1: Documents about new -P functionality and many grammatical, pharsing, formatting and punctuation fixes * docs: Document setting platform with -P is a Procursus extension * docs: Document using -arch and -e together
-rw-r--r--docs/ldid.17
-rw-r--r--docs/ldid.zh_CN.189
-rw-r--r--docs/ldid.zh_TW.175
3 files changed, 109 insertions, 62 deletions
diff --git a/docs/ldid.1 b/docs/ldid.1
index 2f13068..4c73610 100644
--- a/docs/ldid.1
+++ b/docs/ldid.1
@@ -74,7 +74,9 @@ in the special codesign slot at
.Ar num .
.It Fl e
Print the entitlements in each slice, or the slice specified by
-.Fl A ,
+.Fl A
+or
+.Fl arch
to
.Ar stdout .
.It Fl H Ns Op Ar sha1 | Ar sha256
@@ -112,6 +114,9 @@ If
.Ar num
is specified, the platform field in the CodeDirectory will be set to that number.
The default is 13, as per Apple binaries.
+Specifying the platform to set to using
+.Fl P
+is a Procursus extension.
.It Fl Q Ns Ar requirements.xml
Embed the requirements found in
.Ar requirements .
diff --git a/docs/ldid.zh_CN.1 b/docs/ldid.zh_CN.1
index ec1ecbb..c7736e1 100644
--- a/docs/ldid.zh_CN.1
+++ b/docs/ldid.zh_CN.1
@@ -20,15 +20,15 @@
.Op Fl H Ns Op Ar sha1 | Ar sha256
.Op Fl h
.Op Fl I Ns Ar 名称
-.Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密码
+.Op Fl K Ns Ar 密钥.p12 Op Fl U Ns Ar 密码
.Op Fl M
-.Op Fl P
+.Op Fl P Ns Op Ar 数字
.Op Fl Q Ns Ar 需求
.Op Fl q
.Op Fl r | Fl S Ns Ar 档案.xml | Fl s
.Op Fl u
.Op Fl arch Ar 架构类型
-.Ar
+.Ar 档案......
.Sh 描述
.Nm
把SHA1和SHA256杂凑值加入到Mach-O档案中,
@@ -36,9 +36,17 @@
.Bl -tag -width -indent
.It Fl A Ns Ar 处理器类型 : Ns Ar 亚类型
当和
-.Fl a , Fl D , Fl e , Fl h , Fl q ,
+.Fl a
+、
+.Fl d
+、
+.Fl e
+、
+.Fl h
+、
+.Fl q
-.Fl u ,
+.Fl u
一起被使用时,只作用在被
.Ar 处理器类型
@@ -55,7 +63,7 @@
.Fl A
一样,不过使用架构的名称。
已知的
-.Ar 架构类型 Ns s
+.Ar 架构类型 Ns
可以在
.Xr arch 3
中找到。
@@ -76,10 +84,13 @@
.Ar 数字
的特殊代码签署位置中。
.It Fl e
-把每一部分的权限印出, 或印出
-.Fl A ,
-所指定的部分的权限
-.Ar 到标准输出。
+把每一部分的权限印出,或印出
+.Fl A
+或
+.Fl arch
+所指定的部分的权限到
+.Ar 标准输出
+。
.It Fl H Ns Op Ar sha1 | Ar sha256
禁用没有指明的杂凑吗。
这个选项可以用来重现
@@ -88,26 +99,35 @@
.It Fl h
印出关于签署的资讯,包括杂凑值的
类型,选项,CDHash, 和 CodeDirectory 版本到
-.Ar 标准输出。
+.Ar 标准输出
+。
.It Fl I Ns Ar 名称
把二进制档案签署中的识别码设定为
-.Ar 名称。
+.Ar 名称
+。
如没有指明,就会使用二进位档案的档案名称。
-.It Fl K Ns Ar 密錀.p12
-用在
-.Ar 密錀.p12 .
-的身份签署。 会给二进位档案有一个有效的签署,令它能够在有签署验证的系统上运行。
+.It Fl K Ns Ar 密钥.p12
+使用位于
+.Ar 密钥.p12
+的身份签署。会给二进位档案有一个有效的签署,令它能够在有签署验证的系统上运行。
如果
-.Ar 密錀.p12
-有密码的话,你会被询问。 也可以用
+.Ar 密钥.p12
+有密码的话,你会被询问。也可以用
.Fl U
选项来提供密码。
.It Fl M
当和
-.Fl S ,
-一起使用时,和现有的权限合并而不是取代它。 在加入权限时有用。
-.It Fl P
-将这个Mach-O二进位档案标示为系统二进位档案。
+.Fl S
+一起使用时,和现有的权限合并而不是取代它。在加入权限时有用。
+.It Fl P Ns Op Ar 数字
+将这个Mach-O二进位档案标示为平台二进位档案。
+如果提供了
+.Ar 数字
+,那么在CodeDirectory中的平台区域定会被设定为该数字。
+根据苹果的二进位档案,预设为13。
+使用
+.Fl P
+来设定平台是一个Procursus扩展。
.It Fl Q Ns Ar 需求
把需求嵌入到
.Ar 需求
@@ -144,46 +164,47 @@
.Pp
指令:
.Pp
-.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 档案"
+.Dl "ldid -Cadhoc -K/path/to/密钥.p12 -S权限.xml 档案"
.Pp
会使用
-.Ar /path/to/密錀.p12
+.Ar /path/to/密钥.p12
中的私錀来签署
.Ar 档案
也会使用在
-.Ar ent.xml ,
+.Ar 权限.xml
中的权限并把签署标示为特别用途 (adhoc) 签署。
.Pp
-指令:
+指令:
.Pp
-.Dl "ldid -Sent.xml -M 档案"
+.Dl "ldid -S权限.xml -M 档案"
.Pp
会把
-.Ar ent.xml
+.Ar 权限.xml
中的权限加入到已经在
-.Ar 档案 .
+.Ar 档案
中的权限。
.Pp
-指令:
+指令:
.Pp
-.Dl "ldid -e 档案 > ent.xml"
+.Dl "ldid -e 档案 > 权限.xml"
.Pp
会把在
.Ar 档案
中每一部分的权限储存到
-.Ar ent.xml .
+.Ar 权限.xml
+。
.Sh 另见
.Xr codesign 1
.Sh 历史
这个
.Nm
工具程式是由
-.An Jay \*qSaurik\*q Freeman . 所编写的。
+.An Jay \*qSaurik\*q Freeman 所编写的。
对iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6号被加入。
.Fl S
在2008年6月13日被加入。
SHA256 支援在2016年8月25日被加入,修正iOS 11支援。
iOS 14支援在2020年7月31日由
-.An Kabir Oberai .
+.An Kabir Oberai
加入。
iOS 15支援在2021年6月11日被加入。
diff --git a/docs/ldid.zh_TW.1 b/docs/ldid.zh_TW.1
index d675d19..9dc80ae 100644
--- a/docs/ldid.zh_TW.1
+++ b/docs/ldid.zh_TW.1
@@ -22,13 +22,13 @@
.Op Fl I Ns Ar 名稱
.Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密碼
.Op Fl M
-.Op Fl P
+.Op Fl P Ns Op Ar 數字
.Op Fl Q Ns Ar 需求
.Op Fl q
.Op Fl r | Fl S Ns Ar 檔案.xml | Fl s
.Op Fl u
.Op Fl arch Ar 架構類型
-.Ar
+.Ar 檔案......
.Sh 描述
.Nm
把SHA1和SHA256雜湊值加入到Mach-O檔案中,
@@ -36,9 +36,17 @@
.Bl -tag -width -indent
.It Fl A Ns Ar 處理器類型 : Ns Ar 亞類型
當和
-.Fl a , Fl D , Fl e , Fl h , Fl q ,
+.Fl a
+、
+.Fl d
+、
+.Fl e
+、
+.Fl h
+、
+.Fl q
-.Fl u ,
+.Fl u
一起被使用時,只作用在被
.Ar 處理器類型
@@ -55,7 +63,7 @@
.Fl A
一樣,不過使用架構的名稱。
已知的
-.Ar 架構類型 Ns s
+.Ar 架構類型 Ns
可以在
.Xr arch 3
中找到。
@@ -76,10 +84,13 @@
.Ar 數字
的特殊代碼簽署位置中。
.It Fl e
-把每一部分的權限印出, 或印出
-.Fl A ,
-所指定的部分的權限
-.Ar 到標準輸出。
+把每一部分的權限印出,或印出
+.Fl A
+或
+.Fl arch
+所指定的部分的權限到
+.Ar 標準輸出
+。
.It Fl H Ns Op Ar sha1 | Ar sha256
禁用沒有指明的雜湊嗎。
這個選項可以用來重現
@@ -88,14 +99,16 @@
.It Fl h
印出關於簽署的資訊,包括雜湊值的
類型,選項,CDHash, 和 CodeDirectory 版本到
-.Ar 標準輸出。
+.Ar 標準輸出
+。
.It Fl I Ns Ar 名稱
把二進制檔案簽署中的識別碼設定為
-.Ar 名稱。
+.Ar 名稱
+。
如沒有指明,就會使用二進位檔案的檔案名稱。
.It Fl K Ns Ar 密錀.p12
-用在
-.Ar 密錀.p12 .
+使用位於
+.Ar 密錀.p12
的身份簽署。會給二進位檔案有一個有效的簽署,令它能夠在有簽署驗證的系統上運行。
如果
.Ar 密錀.p12
@@ -104,10 +117,17 @@
選項來提供密碼。
.It Fl M
當和
-.Fl S ,
+.Fl S
一起使用時,和現有的權限合併而不是取代它。在加入權限時有用。
-.It Fl P
-將這個Mach-O二進位檔案標示為系統二進位檔案。
+.It Fl P Ns Op Ar 數字
+將這個Mach-O二進位檔案標示為平台二進位檔案。
+如果提供了
+.Ar 數字
+,那麼在CodeDirectory中的平台區域定會被設定為該數字。
+根據蘋果的二進位檔案,預設為13。
+使用
+.Fl P
+來設定平台是一個Procursus擴展。
.It Fl Q Ns Ar 需求
把需求嵌入到
.Ar 需求
@@ -144,46 +164,47 @@
.Pp
指令:
.Pp
-.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 檔案"
+.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -S權限.xml 檔案"
.Pp
會使用
.Ar /path/to/密錀.p12
中的私錀來簽署
.Ar 檔案
也會使用在
-.Ar ent.xml ,
+.Ar 權限.xml
中的權限並把簽署標示為特別用途 (adhoc) 簽署。
.Pp
-指令:
+指令:
.Pp
-.Dl "ldid -Sent.xml -M 檔案"
+.Dl "ldid -S權限.xml -M 檔案"
.Pp
會把
-.Ar ent.xml
+.Ar 權限.xml
中的權限加入到已經在
-.Ar 檔案 .
+.Ar 檔案
中的權限。
.Pp
-指令:
+指令:
.Pp
-.Dl "ldid -e 檔案 > ent.xml"
+.Dl "ldid -e 檔案 > 權限.xml"
.Pp
會把在
.Ar 檔案
中每一部分的權限儲存到
-.Ar ent.xml .
+.Ar 權限.xml
+。
.Sh 另見
.Xr codesign 1
.Sh 歷史
這個
.Nm
工具程式是由
-.An Jay \*qSaurik\*q Freeman . 所編寫的。
+.An Jay \*qSaurik\*q Freeman 所編寫的。
對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
.Fl S
在2008年6月13日被加入。
SHA256 支援在2016年8月25日被加入,修正iOS 11支援。
iOS 14支援在2020年7月31日由
-.An Kabir Oberai .
+.An Kabir Oberai
加入。
iOS 15支援在2021年6月11日被加入。