From c62968304976748c7671fd3a56d255e5cad5b291 Mon Sep 17 00:00:00 2001 From: Nick Chan Date: Sat, 23 Jul 2022 08:10:00 +0800 Subject: 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 --- docs/ldid.1 | 7 ++++- docs/ldid.zh_CN.1 | 89 ++++++++++++++++++++++++++++++++++--------------------- docs/ldid.zh_TW.1 | 75 +++++++++++++++++++++++++++++----------------- 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日被加入。 -- cgit v1.2.3-56-ge451