Aksal/nuttx
3
1
Fork 1
mirror of https://github.com/apache/nuttx.git synced 2026-10-10 07:40:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

include/ar.h: Add the archive file header.

Browse source 
Programs that read the members of archive (.a) files include <ar.h>
for struct ar_hdr and the ARMAG, SARMAG and ARFMAG constants, and
NuttX did not have it.  The header describes the common ar file
format: the magic string, then a 60-byte ASCII header per member.

Assisted-by: Claude Code:claude-opus-5-5
Signed-off-by: Marco Casaroli <marco.casaroli@gmail.com>
This commit is contained in:
Marco Casaroli 2026-10-08 21:58:51 +02:00 • committed by Xiang Xiao
parent a661949f8a
commit 73760338dc
1 changed files with 55 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

55
include/ar.h Normal file
View file

@ -0,0 +1,55 @@
/****************************************************************************
* include/ar.h
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
#ifndef __INCLUDE_AR_H
#define __INCLUDE_AR_H
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* The layout of an archive (.a) file, as written by ar(1): the magic string
* ARMAG, then one struct ar_hdr per member, each followed by the member
* data padded to an even size. All header fields are ASCII, padded with
* spaces.
*/
#define ARMAG "!<arch>\n" /* Magic string at the start of the file */
#define SARMAG 8 /* Length of ARMAG */
#define ARFMAG "`\n" /* Value of ar_fmag in every header */
/****************************************************************************
* Public Types
****************************************************************************/
struct ar_hdr
{
char ar_name[16]; /* Member name, terminated by '/' (GNU) or a space */
char ar_date[12]; /* Modification time, decimal seconds since the epoch */
char ar_uid[6]; /* Owner user ID, decimal */
char ar_gid[6]; /* Owner group ID, decimal */
char ar_mode[8]; /* File mode, octal */
char ar_size[10]; /* Size of the member data in bytes, decimal */
char ar_fmag[2]; /* Always ARFMAG */
};
#endif /* __INCLUDE_AR_H */