Luojh add library in dev by ustcljh · Pull Request #60 · ustclug/Linux201-docs

ustcljh · 2025-09-02T07:23:18Z

No description provided.

cloudflare-workers-and-pages · 2025-09-02T07:23:40Z

Deploying linux201-docs with Cloudflare Pages

Latest commit:	`2376e8f`
Status:	✅ Deploy successful!
Preview URL:	https://b30b932f.linux201-docs.pages.dev
Branch Preview URL:	https://luojh-add-library-in-dev.linux201-docs.pages.dev

View logs

…1-docs into luojh-add-library-in-dev

mkdocs.yml

docs/dev/library.md

…1-docs into luojh-add-library-in-dev

ustcljh · 2025-09-02T12:45:24Z

这个 build CI failed 是正常的吧 @RTXUX

taoky · 2025-09-02T14:58:06Z

mkdocs.yml

-      - Golang: dev/language/golang.md
-    - 版本管理与合作: dev/git.md
-    - SSH 使用技巧: dev/ssh.md
+      - dev/index.md


不要修改这个文件的 indentation

taoky · 2025-09-02T14:58:48Z

mkdocs.yml

+        - Golang: dev/language/golang.md
+      - 版本管理与合作: dev/git.md
+      - SSH 使用技巧: dev/ssh.md
+      - Linux 上的链接库: dev/library.md


层级需在「编程语言概览」下面，预期是在 cxx.md 里面。现在的内容量没法单列一个 page。

taoky · 2025-09-02T15:01:25Z

docs/dev/library.md

@@ -0,0 +1,118 @@
+---
+icon: simple/cplusplus


换个图标，和 C/C++ 的重复了

material/book 或者 material/book-cog 不错，material/bookmark-box 也行

taoky · 2025-09-02T15:01:38Z

docs/dev/library.md

+icon: simple/cplusplus
+---
+
+# 链接库


主标题名称需与 nav 里面一致。

taoky · 2025-09-02T15:02:21Z

docs/dev/library.md

+
+!!! comment "适用范围"
+
+    本文介绍 Linux 上的**静态链接库** (一般为 `.a` 文件) 和**动态链接库** (一般为 `.so` 文件)。注意：这里的链接库是指包含了可执行二进制代码的库，并不是头文件 (Header file)、Python 库等。


括号内包含中文的情况下使用全角括号，下面其他的也一样。

Header file 不需要大写，header file 就够了

taoky · 2025-09-02T15:05:30Z

docs/dev/library.md

+header["头文件 (*.h)"] --- source
+target --> linker["链接器"]
+staticlib["**静态链接库** (链接步骤加入)"] --> linker
+linker --> executable["可执行文件 (ELF等)"]


Suggested change

linker --> executable["可执行文件 (ELF等)"]

linker --> executable["可执行文件（ELF 等）"]

taoky · 2025-09-02T15:20:33Z

docs/dev/library.md

+以便其他使用链接库的程序**知道如何使用这个函数** (即使这些程序不知道函数内部的实现)。
+
+因为链接库不是完整的、可以独立运行的程序，因此不需要入口点 (比如 `main` 函数)。
+


介绍一下 extern。

taoky · 2025-09-02T15:23:06Z

docs/dev/library.md

+header["头文件 (*.h)"] --- source
+target -->|链接| executable["可执行文件 (ELF等)"]
+target -->|ar rcs| staticlib["静态链接库 (*.a)"]
+target -->|gcc -shared| dynamiclib["动态链接库 (*.a)"]


Suggested change

target -->|gcc -shared| dynamiclib["动态链接库 (*.a)"]

target -->|<code>gcc -shared</code>| dynamiclib["动态链接库 (*.a)"]

上面的 ar rcs 也可以这么做。

taoky · 2025-09-02T15:24:01Z

docs/dev/library.md

+int square(int x);
+```
+
+以便其他使用链接库的程序**知道如何使用这个函数** (即使这些程序不知道函数内部的实现)。


有必要讲一下预处理。

tiankaima · 2025-09-04T14:02:53Z

docs/dev/library.md

+
+这里，`-L./lib` 表示要求链接器在 `./lib` 中寻找链接库，`-lsquare` 表示需要链接 `libsquare.a` 这个静态链接库文件。
+
+编译好之后，就可以正常使用了。由于静态链接库中的代码会被直接合并到链接产生的可执行文件 `main` 中，因此运行时不需要文件 `libsquare.a`。


frankly 读到这里结束我稍微~~有点意外~~，更期待一点 in-depth 的内容……

目前这个内容量大概可以作为 101 的拓展内容……？如果介绍一些 LD_LIBRARY_PATH（例如不同 CUDA 版本等）/打包相关的也许更适合放在 201 一些。

现在这个分量确实是不够的

…1-docs into luojh-add-library-in-dev

ustcljh · 2025-09-08T17:58:54Z

目前内容确实是偏少的，也和我最近正在准备这个稿子有关系。对于201来说，这个部分可能不只写链接库，可能更偏向于一个稍微丰富一些的C构建系统的介绍？

ustcljh and others added 2 commits September 2, 2025 15:22

Add overview ans static linked library.

92f41c8

[autofix.ci] apply automated fixes

f4ce434

ustcljh had a problem deploying to github-pages September 2, 2025 07:23 — with GitHub Actions Failure

ustcljh added 2 commits September 2, 2025 15:24

Add nav link to library.md

fcfc89a

Merge branch 'luojh-add-library-in-dev' of github.com:ustclug/Linux20…

241e4bb

…1-docs into luojh-add-library-in-dev

ustcljh had a problem deploying to github-pages September 2, 2025 07:25 — with GitHub Actions Failure

ustcljh requested review from MirageTurtle, RTXUX, iBug, taoky and tiankaima September 2, 2025 07:38

RTXUX requested changes Sep 2, 2025

View reviewed changes

mkdocs.yml Show resolved Hide resolved

docs/dev/library.md Outdated Show resolved Hide resolved

iBug requested changes Sep 2, 2025

View reviewed changes

docs/dev/library.md Outdated Show resolved Hide resolved

docs/dev/library.md Outdated Show resolved Hide resolved

docs/dev/library.md Outdated Show resolved Hide resolved

docs/dev/library.md Outdated Show resolved Hide resolved

ustcljh added 2 commits September 2, 2025 20:36

Fix many typos

20d8439

Fix formatting on prettier

b6703e4

ustcljh had a problem deploying to github-pages September 2, 2025 12:42 — with GitHub Actions Failure

ustcljh added 2 commits September 2, 2025 20:43

Fix formatting on prettier & fix typo

7a50397

Merge branch 'luojh-add-library-in-dev' of github.com:ustclug/Linux20…

ef01039

…1-docs into luojh-add-library-in-dev

ustcljh had a problem deploying to github-pages September 2, 2025 12:43 — with GitHub Actions Failure

ustcljh requested review from RTXUX and iBug September 2, 2025 12:43

ustcljh and others added 4 commits September 2, 2025 22:55

Add overview ans static linked library.

f8d853b

Add nav link to library.md

7ba354c

[autofix.ci] apply automated fixes

a22ab5c

Fix many typos

d8a7d96

Fix formatting on prettier & fix typo

8d404dd

taoky force-pushed the luojh-add-library-in-dev branch from ef01039 to 8d404dd Compare September 2, 2025 14:55

taoky requested changes Sep 2, 2025

View reviewed changes

iBug added 2 commits September 2, 2025 23:42

Merge branch 'master' into luojh-add-library-in-dev

b091284

Merge branch 'master' into luojh-add-library-in-dev

789c179

tiankaima reviewed Sep 4, 2025

View reviewed changes

ustcljh added 2 commits September 5, 2025 19:37

Update dev/library

43b4eaf

Merge branch 'luojh-add-library-in-dev' of github.com:ustclug/Linux20…

2376e8f

…1-docs into luojh-add-library-in-dev

iBug force-pushed the master branch from cb15f5c to 8a6ceff Compare November 29, 2025 18:52


		!!! comment "适用范围"

		本文介绍 Linux 上的静态链接库 (一般为 `.a` 文件) 和动态链接库 (一般为 `.so` 文件)。注意：这里的链接库是指包含了可执行二进制代码的库，并不是头文件 (Header file)、Python 库等。

	linker --> executable["可执行文件 (ELF等)"]
	linker --> executable["可执行文件（ELF 等）"]

		以便其他使用链接库的程序知道如何使用这个函数 (即使这些程序不知道函数内部的实现)。

		因为链接库不是完整的、可以独立运行的程序，因此不需要入口点 (比如 `main` 函数)。

	target -->\|gcc -shared\| dynamiclib["动态链接库 (*.a)"]
	target -->\|<code>gcc -shared</code>\| dynamiclib["动态链接库 (*.a)"]


		这里，`-L./lib` 表示要求链接器在 `./lib` 中寻找链接库，`-lsquare` 表示需要链接 `libsquare.a` 这个静态链接库文件。

		编译好之后，就可以正常使用了。由于静态链接库中的代码会被直接合并到链接产生的可执行文件 `main` 中，因此运行时不需要文件 `libsquare.a`。

Conversation

ustcljh commented Sep 2, 2025

Uh oh!

cloudflare-workers-and-pages bot commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying linux201-docs with Cloudflare Pages

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ustcljh commented Sep 2, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ustcljh commented Sep 8, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

cloudflare-workers-and-pages bot commented Sep 2, 2025 •

edited

Loading