
マニュアルページのさまざまな部分が何を表すかについて、次のQAの回答を読んでいます。マニュアルページの数字はどういう意味ですか?
この記事を読んで、どの部分がCデータ構造の説明なのかわかりません。 C関数の説明のようにセクション3に配置されますか、それとも別のセクションに配置されますか?
マニュアルページのどの部分がCデータ構造に関するものであり、私が受け取った答えがオペレーティングシステムスイートの特定の特徴に限定されないことを理解することが重要です。誰にでも標準的な答えが必要です。
答え1
C構造は一般に、最も関連性の高い機能のマニュアルページに詳細に記載されている。たとえば、
- この構造は(システムコール)で定義されています
struct sockaddr
。bind(2)
- 構造は
struct utmp
(ファイル形式:utmp)で定義されます。utmp(5)
マニュアルページに構造の詳細を提供するための開発者の特別な要件はありません。これは、基本的にはコメント付きのヘッダーファイルの操作であるためです(参考文献を参照/usr/include
)。
一般に、構造に関する詳細を探している場合は、その構造を使用する機能を確認してください。たとえば、asctime
パラメータ()についてさらに詳しく知りたい場合は、struct tm
次を参照してください。asctime
マニュアルページ。ほとんどの構造には、これを操作するための一連の関数が付属しており、これらの関数には通常マニュアルページがあります。構造に関連する機能がない場合は、次のようないくつかのオプションがあります。
- この構造は、概念(
struct sockaddr_un
UNIXソケットなど)と密接に関連しています。この概念に関連するマニュアルページを確認してください(ここunix(7)
)。 - この構造は、ファイルに関連付けるか、ファイルを解析するために使用されます(例
struct utmp
:)。利用可能な場合は、ファイルのマニュアルページを参照してください(こちらutmp(5)
)。 - この構造は、どのマニュアルページにも文書化されていないようです。これを定義するヘッダファイルを確認してください。
struct ifaddrs
マンページがありますが、例は次のとおりですgetifaddrs(3)
。
文書:/usr/include/ifaddrs.h
struct ifaddrs
{
struct ifaddrs *ifa_next; /* Pointer to the next structure. */
char *ifa_name; /* Name of this network interface. */
unsigned int ifa_flags; /* Flags as from SIOCGIFFLAGS ioctl. */
struct sockaddr *ifa_addr; /* Network address of this interface. */
struct sockaddr *ifa_netmask; /* Netmask of this interface. */
// ...
};