[关闭]
@devilogic 2016-08-12T06:21:04.000000Z 字数 31273 阅读 3863

libelf库分析

devilogic


介绍

libelfREDHAT的一个操作elf文件的开发库。我将安卓NDK4.4.2版本中的库扒出来了。直接make all即可编译。作为我另外一个项目的开发库。代码链接如下:
https://git.coding.net/devilogic/ydog.git
本来想把自己原来写的库来用,但是发现这个的实现比自己写的要好的多。主要好在哪里呢?有几下几点:
1. 考虑到了32/64位的问题,但是对外只需要操作一个elf结构即可。
2. 考虑到了大小端字序的转换。
3. 考虑到了ELF文件版本对其结构的印象,虽然好几十年了这个版本仍然是1,本人希望永远是1。
4. 以多种方式对elf文件进行操作,例如映射内存,直接打开文件,并且带有严格的权限控制。
5. 考虑到了多线程同时操作一个elf结构的问题。是线程安全的。
6. 内存地址页对齐。
7. 不仅支持elf文件,还支持静态库(.a)文件。
8. 当是自己创建一个elf结构时,
9. 考虑到一些自己没有对ELF文档读全的问题。。。-_-!!!

一个例子

下面是摘自objdump.c中的一个使用实例。当objdump接收到要反汇编的程序文件后,就会调用此函数。

  1. static int
  2. process_file (const char *fname, bool more_than_one) {
  3. /* 以只读权限打开,并且获取文件句柄 */
  4. int fd = open (fname, O_RDONLY);
  5. if (fd == -1) {
  6. error (0, errno, gettext ("cannot open %s"), fname);
  7. return 1;
  8. }
  9. /* 获取elf描述符,使用‘读取映射’的方式
  10. * 首先要获取这个结构,以下所有就是对这个结构进行操作
  11. */
  12. Elf *elf = elf_begin (fd, ELF_C_READ_MMAP, NULL);
  13. if (elf != NULL) {
  14. /* 确定是文件类型是否是ELF文件 */
  15. if (elf_kind (elf) == ELF_K_ELF) {
  16. int result = handle_elf (elf, more_than_one ? "" : NULL,
  17. fname, NULL);
  18. if (elf_end (elf) != 0)
  19. INTERNAL_ERROR (fname);
  20. if (close (fd) != 0)
  21. error (EXIT_FAILURE, errno, gettext ("while close `%s'"), fname);
  22. return result;
  23. } else if (elf_kind (elf) == ELF_K_AR) { /* 目标是库文件 */
  24. int result = handle_ar (fd, elf, NULL, fname, NULL);
  25. if (elf_end (elf) != 0)
  26. INTERNAL_ERROR (fname);
  27. if (close (fd) != 0)
  28. error (EXIT_FAILURE, errno, gettext ("while close `%s'"), fname);
  29. return result;
  30. }
  31. /* 关闭elf结构句柄 */
  32. if (elf_end (elf) != 0)
  33. INTERNAL_ERROR (fname);
  34. }
  35. error (0, 0, gettext ("%s: File format not recognized"), fname);
  36. return 1;
  37. }

接下来看看在handle_elf中的处理。

  1. static int
  2. handle_elf (Elf *elf, /* elf结构指针 */
  3. const char *prefix, /* 如果为NULL表明接下来没有文件要处理 */
  4. const char *fname, /* 要处理的文件名 */
  5. const char *suffix /* 后缀 */) {
  6. /* 获取当前的ebl的指针
  7. * libebl也是elfunits中一个非常重要的组件库
  8. * 也是在我的分析范围之内,它也用到了libelf库
  9. * 这里先不用去理会它。
  10. */
  11. Ebl *ebl = ebl_openbackend (elf);
  12. /* 打印当前的文件信息,使用gelf_getclass获取当前elf文件的位数 */
  13. printf ("%s: elf%d-%s\n\n",
  14. fname,
  15. gelf_getclass (elf) == ELFCLASS32 ? 32 : 64,
  16. ebl_backend_name (ebl));
  17. /* 创建这个文件完整的文件名称 */
  18. /* 忽悠没有的代码... */
  19. /* 获取节名称表节索引 */
  20. size_t shstrndx;
  21. if (elf_getshstrndx (ebl->elf, &shstrndx) < 0)
  22. error (EXIT_FAILURE, 0,
  23. gettext ("cannot get section header string table index"));
  24. int result = 0;
  25. if (print_disasm)
  26. result = show_disasm (ebl, fullname, shstrndx);
  27. if (print_relocs && !print_disasm)
  28. result = show_relocs (ebl, fullname, shstrndx);
  29. if (print_full_content)
  30. result = show_full_content (ebl, fullname, shstrndx);
  31. /* 关闭ebl句柄 */
  32. ebl_closebackend (ebl);
  33. return result;
  34. }

接下来看看show_relocs里的工作。

  1. static int
  2. show_relocs (Ebl *ebl, const char *fname, uint32_t shstrndx) {
  3. int elfclass = gelf_getclass (ebl->elf);/* 获取elf文件的位数 */
  4. /* Elf_Scn是libelf中保存节信息的结构 */
  5. Elf_Scn *scn = NULL;
  6. /* 遍历节 */
  7. while ((scn = elf_nextscn (ebl->elf, scn)) != NULL) {
  8. GElf_Shdr shdr_mem;
  9. /* 复制节头,libelf有个特点
  10. * 但凡带g开头的函数都是复制操作,不对本身映射进行直接操作
  11. */
  12. GElf_Shdr *shdr = gelf_getshdr (scn, &shdr_mem);
  13. if (shdr == NULL)
  14. INTERNAL_ERROR (fname);
  15. /* 如果节类型是重定位节 */
  16. if (shdr->sh_type == SHT_REL || shdr->sh_type == SHT_RELA) {
  17. /* elf_ndxscn用于获取当前节的索引
  18. * 这里就是匹配是否是用户指定的节
  19. */
  20. if (! section_match (ebl->elf, elf_ndxscn (scn), shdr, shstrndx))
  21. continue;
  22. GElf_Shdr destshdr_mem;
  23. /* 复制一个节头出来 */
  24. GElf_Shdr *destshdr =
  25. gelf_getshdr (elf_getscn (ebl->elf,
  26. shdr->sh_info),
  27. &destshdr_mem);
  28. /* elf_strptr可以获取当前字符串表的字符串 */
  29. printf (gettext ("RELOCATION RECORDS FOR [%s]:\n"
  30. "%-*s TYPE VALUE\n"),
  31. elf_strptr (ebl->elf, shstrndx, destshdr->sh_name),
  32. elfclass == ELFCLASS32 ? 8 : 16, gettext ("OFFSET"));
  33. /* 获取节数据
  34. * elf_getdata是通过节结构获取
  35. * 节数据,libelf中将节数据保存到
  36. * 一个Elf_Data结构中
  37. */
  38. Elf_Data *data = elf_getdata (scn, NULL);
  39. if (data == NULL)
  40. continue;
  41. /* 获取符号表信息 */
  42. Elf_Scn *symscn = elf_getscn (ebl->elf, shdr->sh_link);
  43. GElf_Shdr symshdr_mem;
  44. GElf_Shdr *symshdr = gelf_getshdr (symscn, &symshdr_mem);
  45. /* 获取符号表数据 */
  46. Elf_Data *symdata = elf_getdata (symscn, NULL);
  47. /* 搜索可选的扩展节索引表 */
  48. Elf_Data *xndxdata = NULL;
  49. Elf_Scn *xndxscn = NULL;
  50. while ((xndxscn = elf_nextscn (ebl->elf, xndxscn)) != NULL) {
  51. GElf_Shdr xndxshdr_mem;
  52. GElf_Shdr *xndxshdr;
  53. /* 复制扩展节索引节的节头 */
  54. xndxshdr = gelf_getshdr (xndxscn, &xndxshdr_mem);
  55. if (xndxshdr != NULL && xndxshdr->sh_type == SHT_SYMTAB_SHNDX
  56. && xndxshdr->sh_link == elf_ndxscn (symscn)) {
  57. /* 如果匹配,找到扩展节索引节的数据 */
  58. xndxdata = elf_getdata (xndxscn, NULL);
  59. break;
  60. }
  61. }/* end while */
  62. /* 按照重定位类型进行输出 */
  63. if (shdr->sh_type == SHT_REL)
  64. show_relocs_rel (ebl, shdr, data, symdata, xndxdata,
  65. symshdr->sh_link, shstrndx);
  66. else
  67. show_relocs_rela (ebl, shdr, data, symdata, xndxdata,
  68. symshdr->sh_link, shstrndx);
  69. }
  70. }
  71. fputs_unlocked ("\n\n", stdout);
  72. return 0;
  73. }

大致就是通过elf_begin打开文件使用elf_end来释放elf结构体内存。期间可以通过提供的函数获取elf文件的信息,如果需要复制其中的值而不是直接获取映射指针,则直接使用gelf开头的函数。如果改动了文件的内容,则使用带update函数进行更新结构,并且最后用elf_update写入到实操文件中。

接口列表

接口名称 说明
elf_begin 用来打开目标文件并进行elf描述符号的映射
elf_clone 用来对现有的elf文件描述符进行克隆
elf_end 用来释放分配elf描述符号
elf_memory 用来从文件的内存映射创建elf文件描述符号
elf_next 如果是库文件,则返回下一个elf文件描述符号
elf_update 对elf文件进行修改后,写入对应文件中
elf_kind 返回文件类型
elf_getbase 获取基地址
elf_getident 取回文件标志数据
elf32_getehdr 获取32位elf文件头
elf64_getehdr 获取64位elf文件头
elf32_newehdr 创建32位elf文件夹头
elf64_newehdr 创建32位elf文件夹头
elf32_getphdr 获取32位段表头
elf64_getphdr 获取64位段表头
elf32_newphdr 创建32位elf段表头
elf64_newphdr 创建64位elf段表头
elf_getscn 从elf描述符获取按照节索引获取节接口
elf32_offscn 从32位elf描述符获取按照节偏移获取节接口
elf64_offscn 从64位elf描述符获取按照节偏移获取节接口
elf_ndxscn 通过节结构获取节的索引
elf_nextscn 通过节结构获取下一个节的结构
elf_newscn 创建一个新的节表添加到节表队列末尾
elf_scnshndx 通过给定的符号表获取扩展节索引表的节索引
elf_getshnum 返回节的数量
elf_getshstrndx 从elf结构中获取节名表索引
elf32_getshdr 获取32位的节表头
elf64_getshdr 获取64位的节表头
elf_flagelf 设置或者清除elf描述符的标志
elf_flagehdr 设置或者清除ehdr头描述符的标志
elf_flagphdr 设置或者清除phdr头描述符的标志
elf_flagscn 设置或者清除节结构描述符的标志
elf_flagdata 设置或者清除数据描述符的标志
elf_flagshdr 设置或者清除节头描述符的标志
elf_getdata 从节中获取节数据(经过了字节序的转换)
elf_rawdata 从节中获取节数据(没有经过了字节序的转换)
elf_newdata 为节结构创建新的数据
elf_getdata_rawchunk 按照偏移获取数据,并进行字节序的转换,最后关联到elf当前操作数据
elf_strptr 从指定的字符串表中通过偏移获取字符串
elf_getarhdr 获取ar库文件的文件描述符号头
elf_getaroff 从库文件中返回当前正在操作的elf文件偏移
elf_rand 选定文件指定的偏移
elf_getarsym 获取库文件的符号表
elf_cntl 对elf描述符进行重写的映射操作
elf_rawfile 返回没有解释的文件内容
elf32_fsize 返回32位下指定个数个指定类型的队列大小
elf64_fsize 返回64位下指定个数个指定类型的队列大小
elf32_xlatetom 在32位下转换数据的字节序结构到内存映射
elf64_xlatetom 在64位下转换数据的字节序结构到内存映射
elf32_xlatetof 在32位下转换数据的字节序结构到文件
elf64_xlatetof 在64位下转换数据的字节序结构到文件
elf_errno 返回最后一次的错误代码
elf_errmsg 返回错误代码的描述
elf_version elf的当前版本
elf_fill 设置填充字节,在填充数据结构时使用
elf_hash 计算HASH值
elf_gnu_hash 使用GNU指定的HASH算法计算hash值
elf32_checksum 计算32位elf文件的校验和
elf64_checksum 计算64位elf文件的校验和
gelf_getclass 获取文件关联的class值
gelf_fsize 返回count个type大小个长度,type的大小按照指定版本version而定
gelf_getehdr 获取elf文件头副本
gelf_update_ehdr 更新elf文件头,将src指定的头信息,写回到elf描述符中
gelf_newehdr 创建ehdr头如果在elf描述符中不存在的话
gelf_offscn 通过偏移获取节结构
gelf_getshdr 通过节结构复制节表头
gelf_update_shdr 更新节结构中的节头
gelf_getphdr 按照段索引复制段表
gelf_update_phdr 更新指定段索引的段表头
gelf_newphdr 创建按照指定个数新的程序段头队列
gelf_xlatetom 转换字节序到内存映射
gelf_xlatetof 转换字节序到文件,其实与gelf_xlatetom一样,没有写入什么文件
gelf_getrel 通过指定的重定位索引复制重定位项
gelf_getrela 通过指定的重定位项目索引复制带偏移的重定位项
gelf_update_rel 通过给定重定位项偏移更新项内容
gelf_update_rela 通过给定重定位项偏移更新项内容(带偏移的重定位项)
gelf_getsym 通过符号索引复制符号结构
gelf_update_sym 通过符号索引更新符号项目
gelf_getsymshndx 返回符号信息与扩展节索引
gelf_update_symshndx 更新符号项的内容与扩展节索引
gelf_getsyminfo 通过给定的符号索引复制附加的符号信息
gelf_update_syminfo 通过给定符号索引更新符号信息
gelf_getdyn 通过给定的索引从动态表获取信息
gelf_update_dyn 通过给定索引在动态表中更新信息
gelf_getmove 通过给定索引获取move结构
gelf_update_move 通过给定索引更新move结构
gelf_getlib 通过给定索引从表中获取库结构
gelf_update_lib 通过给定索引从表中更新库结构
gelf_getversym 通过给定索引返回符号版本信息
gelf_update_versym 更新符号版本信息
gelf_getverneed 通过给定偏移返回符号的版本信息
gelf_update_verneed 更新符号版本信息
gelf_getvernaux 通过给定偏移返回附加的符号版本信息
gelf_update_vernaux 更新附加的符号版本信息
gelf_getverdef 通过给定偏移获取符号版本定义信息
gelf_getverdaux 通过给定偏移返回附加符号版本定义信息
gelf_update_verdaux 更新附加符号版本定义信息
gelf_getauxv 通过给定索引获取辅助项
gelf_update_auxv 通过给定索引更新辅助项
gelf_getnote 通过数据偏移,note的名称偏移与描述数据偏移获取note头。返回下一个note的头的偏移,或者0,对于一个错误偏移或者一个错误的note头
gelf_checksum 计算ELF不变部分的校验和

结构说明

名称 文件 说明
Elf libelfP.h 对Elf整体进行封装

struct Elf

最重要的结构Elf结构在libelfP.h中进行定义。这套库就是通过围绕这个结构来展开工作的。它也将库文件与ELF文件直接通过一个结构包装起来,无论是库文件还是单独的ELF文件只要操作这个结构即可。随后它还封装了32位与64位的操作。在外部开来此结构是无位数说明的。

  1. struct Elf {
  2. Elf_Kind kind; /* 表名当前的elf文件类型,是文件还是库 */
  3. Elf_Cmd cmd; /* 创建这个描述符所使用的命令 */
  4. unsigned int class; /* 是32位还是64位 */
  5. int fildes; /* 当前elf结构的文件描述符号. -1表示无效 */
  6. off_t start_offset; /* 如果这个elf是一个库文件,则字段表示子文件的开始偏移 */
  7. size_t maximum_size; /* 文件的最大长度 */
  8. void *map_address; /* 文件映射地址,NULL表示不支持映射 */
  9. int flags; /* 文件标志,标志说明会更详细一些 */
  10. Elf *parent; /* 当一个库文件成员被创建,这个指针指向库文件本身 */
  11. rwlock_define (,lock);/* 多线程锁 */
  12. int ref_count; /* 描述符引用计数 */
  13. struct Elf *next; /* 当库文件描述符时使用,表示下一个在库中的elf文件 */
  14. /* 这是一个联合体,这很重要,一些技巧性的体现 */
  15. union {
  16. /* 通用头标记 */
  17. struct {
  18. int ehdr_flags; /* ELF头的标记(主要是dirty标记,表明是否被修改) */
  19. int phdr_flags; /* 程序头标记(主要是dirty|malloc两个) */
  20. int shdr_malloced; /* 非零,如果shdr队列是内存动态分配的 */
  21. /* 这些指针仅仅是当测试 ==/!= NULL时
  22. * 这几个指针的偏移与elf32,elf64中的
  23. * ehdr,shdr,phdr相对应。记住这是一个联合体
  24. */
  25. void *ehdr;
  26. void *shdr;
  27. void *phdr;
  28. Elf_ScnList *scns_last; /* 节表中最后一个节指针,如果为NULL表示
  29. * 还没有从文件中读取。 */
  30. Elf_Data_Chunk *rawchunks; /* elf_getdata_rawchunk结构的链表,内存原始数据 */
  31. unsigned int scnincr; /* 最后一次分配的节数量 */
  32. off64_t sizestr_offset; /* size字符串在库文件中的偏移 */
  33. } elf;
  34. /* 这里就是联合体的好处,以下定义了具体的32位与64位,但是一些通用性验证
  35. * 可以通过以上的字段,底下的就是具体定义与上面定义大同小异。但是再末尾
  36. * 又加入了自己特有的一些字段。
  37. */
  38. /* 32为elf头 */
  39. struct {
  40. /* 这部分与通用性的一致 */
  41. Elf32_Ehdr ehdr_mem; /* 当文件读写方式打开时,保存elf头的区域 */
  42. char __e32scnspad[sizeof (Elf64_Ehdr) - sizeof (Elf32_Ehdr)];/* 与64位对齐 */
  43. Elf_ScnList scns; /* 真正保存节队列数据的地方 */
  44. } elf32;
  45. /* 64为elf头 */
  46. struct {
  47. /* 这里与32位一样,不过是少了__e32scnspad对齐数据 */
  48. } elf64;
  49. /* 库文件头,其实我对库文件结构并不怎么关心~~~ */
  50. struct {
  51. int has_index; /* 当文件存在索引时设置,0表示不确定,大于0表示有一个 */
  52. Elf_Arsym *ar_sym; /* 通过elf_getarsym返回的符号表 */
  53. size_t ar_sym_num; /* 符号表`ar_sym'的符号数量 */
  54. char *long_names; /* 指向库文件名表 */
  55. size_t long_names_len; /* 名称表的长度 */
  56. off_t offset; /* 在这个库中当前我们选取文件的偏移。elf_next()函数
  57. 将改变这个值到下一个文件。 */
  58. Elf_Arhdr elf_ar_hdr; /* 通过'elf_getarhdr'返回的自己定义的库头 */
  59. struct ar_hdr ar_hdr; /* 标准的库文件头 */
  60. char ar_name[16]; /* 在elf_ar_hdr中以NUL结尾的ar_name */
  61. char raw_name[17];
  62. struct Elf *children; /* 这个库的所有ELF描述符 */
  63. } ar;
  64. } state;
  65. };

节的一些结构

首先看下Elf_Scn。毕竟elf格式的各种不同种类的节拼凑成的。

  1. /* ELF节的描述符 */
  2. struct Elf_Scn {
  3. /* 我们不得不区分几种不同的情况
  4. * 1. 节是用户自己创建的。 在这种情况下没有文件或者内存映射提供数据读取。
  5. * 这里我们定义两种不同的子情况:
  6. *
  7. * a) 数据没有被添加 (在调用`elf_newdata`之前)
  8. * b) 至少一个数据集是有效的
  9. *
  10. * 2. 这个节是从一个文件/内存映射区域读取而来。我们不得不从一个数据块中读
  11. * 读取正确的内容。但是我们不读取数据直到读取是必须的。因此我们也有三种
  12. * 情况:
  13. *
  14. * a) 在文件中的节是0长度的(因为一些原因)
  15. * b) 文件没有被读取
  16. * c) 数据可读并且有效
  17. *
  18. * 我们有不同的数据集,原始与转换后的数据。这需要区分数据仅从文件中读取。
  19. * 还是用户添加的数据集合(但是首先当读取从文件或者是用户创建的节)这两者
  20. * 都是相同的字节格式。我们不创建字节转换数据在它是必要之前。
  21. *
  22. * 在原始数据的字节格式`data_read`元素标记数据是有效的。
  23. *
  24. * 如果有数据从文件或者内存映射区域或者读取一个数据集合被添加`rawdata_list_read`
  25. * 指针为非空并且指向最后填充的数据集。`raw_datalist_rear`是NULL,如果数据集合
  26. * 没有被设置。
  27. *
  28. * 这允许区分两种状况(`rawdata_list`与`data_list`两项都被初始化为0)是在没有
  29. * 从文件或者内存映射中读取数据并且一个节是0长度并且类型是ELF_T_BYTE。
  30. */
  31. Elf_Data_List data_list; /* 数据缓存列表,节的数据保存到这个列表 */
  32. Elf_Data_List *data_list_rear; /* 指向数据列表 */
  33. Elf_Data_Scn rawdata; /* 在节中不解释的数据 */
  34. int data_read; /* 非0值:如果节被用户创建或者数据从文件/内存中读取 */
  35. int shndx_index; /* 与符号表节关联节的索引(如果这个节是符号) */
  36. size_t index; /* 这个节的索引 */
  37. struct Elf *elf; /* 与之关联的ELF指针 */
  38. /* 接头指针 */
  39. union {
  40. Elf32_Shdr *e32; /* 指向32位原始节表结构 */
  41. Elf64_Shdr *e64; /* 指向64位原始节表结构 */
  42. } shdr;
  43. unsigned int shdr_flags; /* 节头是否被修改? */
  44. unsigned int flags; /* 在长度上节被修改过 */
  45. char *rawdata_base; /* 没有修改的节的原始数据 */
  46. char *data_base; /* 经过转换后的节数据 */
  47. struct Elf_ScnList *list; /* 指向数据中的节列表元素,可以访问到其他的节 */
  48. };

在上面的结构中出现了节数据的结构,这个结构用来将数据封装起来。下面就是节数据结构。

  1. /* 将数据存储结果与所属节对应起来 */
  2. typedef struct {
  3. Elf_Data d; /* 更通用的数据结构 */
  4. Elf_Scn *s; /* 表示它所属哪个节 */
  5. } Elf_Data_Scn;

节数据列表结构,在每个节中,还涉及到分区的操作。在下面分析elf_begin时会详细探讨。

  1. /* `Elf_Data`描述列表 */
  2. typedef struct Elf_Data_List {
  3. Elf_Data_Scn data; /* `data` 必须是此结构的第一个元素 */
  4. struct Elf_Data_List *next; /* 下一个节数据指针 */
  5. int flags; /* 数据的标志 */
  6. } Elf_Data_List;

data放到第一个字段以及在Elf_Data_Scn中将Elf_Data放到第一个的好处就是如下所示直接做类型转换很方便。

  1. Elf_Data_List *list = xxx;
  2. Elf_Data *d = (Elf_Data*)(list);

接下来就是保存每个节的链表结构

  1. /* 节列表 */
  2. typedef struct Elf_ScnList {
  3. unsigned int cnt; /* 'data'字段使用的数量 */
  4. unsigned int max; /* 'data'字段最大的分配数量 */
  5. struct Elf_ScnList *next; /* 下一个节列表区块 */
  6. struct Elf_Scn data[0]; /* 节表数据 */
  7. } Elf_ScnList;

以下就是获取原始数据(不经过字节序转换的数据)的结构。

  1. /* elf_getdata_rawchunk函数返回的结果结构 */
  2. typedef struct Elf_Data_Chunk {
  3. Elf_Data_Scn data; /* 数据 */
  4. union {
  5. Elf_Scn dummy_scn; /* 傀儡节 */
  6. struct Elf_Data_Chunk *next; /* 下一片数据 */
  7. };
  8. } Elf_Data_Chunk;

最后看看真正保存数据的结构。这个结构在libelf.h中定义。

  1. /* 描述数据 */
  2. typedef struct {
  3. void *d_buf; /* 指向真实的数据 */
  4. Elf_Type d_type; /* 这段数据的类型 */
  5. unsigned int d_version; /* ELF版本 */
  6. size_t d_size; /* 数据长度 */
  7. /* ANDROID_CHANGE_BEGIN,这是android自己的修改 */
  8. #if 0
  9. loff_t d_off; /* 节的偏移 */
  10. #else
  11. off_t d_off; /* 节的偏移 */
  12. #endif
  13. /* ANDROID_CHANGE_END */
  14. size_t d_align; /* 节的对齐粒度 */
  15. } Elf_Data;

标志说明

  1. /* 在这个库中将各个类型标记了出来,当获取类型长度时使用 */
  2. typedef enum {
  3. ELF_T_BYTE, /* unsigned char */
  4. ELF_T_ADDR, /* Elf32_Addr, Elf64_Addr, ... */
  5. ELF_T_DYN, /* Dynamic section record. */
  6. ELF_T_EHDR, /* ELF header. */
  7. ELF_T_HALF, /* Elf32_Half, Elf64_Half, ... */
  8. ELF_T_OFF, /* Elf32_Off, Elf64_Off, ... */
  9. ELF_T_PHDR, /* Program header. */
  10. ELF_T_RELA, /* Relocation entry with addend. */
  11. ELF_T_REL, /* Relocation entry. */
  12. ELF_T_SHDR, /* Section header. */
  13. ELF_T_SWORD, /* Elf32_Sword, Elf64_Sword, ... */
  14. ELF_T_SYM, /* Symbol record. */
  15. ELF_T_WORD, /* Elf32_Word, Elf64_Word, ... */
  16. ELF_T_XWORD, /* Elf32_Xword, Elf64_Xword, ... */
  17. ELF_T_SXWORD, /* Elf32_Sxword, Elf64_Sxword, ... */
  18. ELF_T_VDEF, /* Elf32_Verdef, Elf64_Verdef, ... */
  19. ELF_T_VDAUX, /* Elf32_Verdaux, Elf64_Verdaux, ... */
  20. ELF_T_VNEED, /* Elf32_Verneed, Elf64_Verneed, ... */
  21. ELF_T_VNAUX, /* Elf32_Vernaux, Elf64_Vernaux, ... */
  22. ELF_T_NHDR, /* Elf32_Nhdr, Elf64_Nhdr, ... */
  23. ELF_T_SYMINFO, /* Elf32_Syminfo, Elf64_Syminfo, ... */
  24. ELF_T_MOVE, /* Elf32_Move, Elf64_Move, ... */
  25. ELF_T_LIB, /* Elf32_Lib, Elf64_Lib, ... */
  26. ELF_T_GNUHASH, /* GNU-style hash section. */
  27. ELF_T_AUXV, /* Elf32_auxv_t, Elf64_auxv_t, ... */
  28. /* Keep this the last entry. */
  29. ELF_T_NUM
  30. } Elf_Type;

命令选项

这些命令多数是针对文件打开的权限操作以及映射方式,ELF_C_CLRELF_C_SET是针对所有结构的flag字段设置与清除标志而言的。多数命令会在elf_begin中详细探讨。

  1. /* 命令 */
  2. typedef enum {
  3. ELF_C_NULL, /* 空... */
  4. ELF_C_READ, /* 以读取权限打开 */
  5. ELF_C_RDWR, /* 以读写权限打开 */
  6. ELF_C_WRITE, /* 以写权限打开 */
  7. ELF_C_CLR, /* 清除标志 */
  8. ELF_C_SET, /* 写入标志 */
  9. ELF_C_FDDONE, /* 标记文件句柄将不会再被使用 */
  10. ELF_C_FDREAD, /* 读取并且重设数据,文件句柄将不会再被使用 */
  11. /* 下面的是扩展 */
  12. ELF_C_READ_MMAP, /* 以读权限映射文件 */
  13. ELF_C_RDWR_MMAP, /* 以读写权限映射文件 */
  14. ELF_C_WRITE_MMAP, /* 以写权限映射文件 */
  15. ELF_C_READ_MMAP_PRIVATE, /* 以读权限映射文件,内存可写,但是不可写回文件 */
  16. ELF_C_EMPTY, /* 拷贝基础的文件数据,但是内容为空 */
  17. /* 最后一个计数而已 */
  18. ELF_C_NUM
  19. } Elf_Cmd;

ELF结构的标志

  1. /* ELF结构的标志 */
  2. enum {
  3. ELF_F_DIRTY = 0x1, /* 一般当改写了原始缓存内存时设置 */
  4. #define ELF_F_DIRTY ELF_F_DIRTY
  5. ELF_F_LAYOUT = 0x4, /* 自己创建组织的elf文件结构时设置 */
  6. #define ELF_F_LAYOUT ELF_F_LAYOUT
  7. ELF_F_PERMISSIVE = 0x8 /* 进行不严格验证 */
  8. #define ELF_F_PERMISSIVE ELF_F_PERMISSIVE
  9. };

ELF_F_PERMISSIVE只在elf32_updatanull.c中使用到一次。

  1. if (shdr->sh_entsize != 0
  2. && unlikely (shdr->sh_size % shdr->sh_entsize != 0)
  3. && (elf->flags & ELF_F_PERMISSIVE) == 0) {
  4. __libelf_seterrno (ELF_E_INVALID_SHENTSIZE);
  5. return -1;
  6. }

上述代码是验证节项的长度是否是节大小的倍数。如果此标志被设置将忽略这一验证。

文件类型

其实就是表明当前操作文件的类型而已。

  1. /* 标识文件类型 */
  2. typedef enum {
  3. ELF_K_NONE, /* 未知 */
  4. ELF_K_AR, /* 静态库 */
  5. ELF_K_COFF, /* coff文件格式 */
  6. ELF_K_ELF, /* elf文件格式 */
  7. /* 无意义 */
  8. ELF_K_NUM
  9. } Elf_Kind;

打开文件函数说明

好吧,这个库是从elf_begin开始的,那就先分析以下这个函数吧!

  1. Elf *elf_begin (int fildes, Elf_Cmd cmd, Elf *ref) {
  2. Elf *retval;
  3. /* 如果版本没有初始化则报错 */
  4. if (unlikely (! __libelf_version_initialized)) {
  5. __libelf_seterrno (ELF_E_NO_VERSION);
  6. return NULL;
  7. }
  8. /* 引用指针不为空 */
  9. if (ref != NULL)
  10. /* 确定描述符不会突然的丢失 */
  11. rwlock_rdlock (ref->lock);
  12. else if (unlikely (fcntl (fildes, F_GETFL) == -1 && errno == EBADF)) {
  13. __libelf_seterrno (ELF_E_INVALID_FILE);
  14. return NULL;
  15. }
  16. /* 锁并且复制elf描述符,稍后分析 */
  17. Elf *lock_dup_elf () {
  18. /* 如果是库文件 */
  19. if (ref->kind == ELF_K_AR) {
  20. rwlock_unlock (ref->lock);
  21. rwlock_wrlock (ref->lock);
  22. }
  23. /* 复制elf描述符 */
  24. return dup_elf (fildes, cmd, ref);
  25. }
  26. /* 命令解析 */
  27. switch (cmd) {
  28. /* 空命令直接退出 */
  29. case ELF_C_NULL:
  30. retval = NULL;
  31. break;
  32. case ELF_C_READ_MMAP_PRIVATE:
  33. /* 如果我们有一个引用,其打开方式必须与当前的相同 */
  34. if (unlikely (ref != NULL && ref->cmd != ELF_C_READ_MMAP_PRIVATE)) {
  35. __libelf_seterrno (ELF_E_INVALID_CMD);
  36. retval = NULL;
  37. break;
  38. }
  39. /* FALLTHROUGH */
  40. /* 以读权限打开 */
  41. case ELF_C_READ:
  42. case ELF_C_READ_MMAP:
  43. /* 如果当前ref不为空,则说明 */
  44. if (ref != NULL)
  45. /* 读取一个elf结构 */
  46. retval = lock_dup_elf ();
  47. else
  48. /* 创建存在文件的描述符 */
  49. retval = read_file (fildes, 0, ~((size_t) 0), cmd, NULL);
  50. break;
  51. /* 以读写权限打开 */
  52. case ELF_C_RDWR:
  53. case ELF_C_RDWR_MMAP:
  54. /* 如果我们有一个引用的对象,则尝试直接复制出来一个 */
  55. if (ref != NULL) {
  56. /* 此段话检测原先的映射必须拥有写权限 */
  57. if (unlikely (ref->cmd != ELF_C_RDWR
  58. && ref->cmd != ELF_C_RDWR_MMAP
  59. && ref->cmd != ELF_C_WRITE
  60. && ref->cmd != ELF_C_WRITE_MMAP)) {
  61. __libelf_seterrno (ELF_E_INVALID_CMD);
  62. retval = NULL;
  63. } else
  64. retval = lock_dup_elf ();
  65. } else /* 创建存在文件的描述符 */
  66. retval = read_file (fildes, 0, ~((size_t) 0), cmd, NULL);
  67. break;
  68. /* 写权限打开 */
  69. case ELF_C_WRITE:
  70. case ELF_C_WRITE_MMAP:
  71. /* 我们忽略引用并且准备一个可写的新文件 */
  72. retval = write_file (fildes, cmd);
  73. break;
  74. default:
  75. __libelf_seterrno (ELF_E_INVALID_CMD);
  76. retval = NULL;
  77. break;
  78. }
  79. /* 释放锁 */
  80. if (ref != NULL)
  81. rwlock_unlock (ref->lock);
  82. return retval;
  83. }

中间内部定义的函数lock_dup_elf只是一个接口函数,做了对库文件的判断就调用了dup_elf函数。

  1. /* 返回一个克隆的存在描述符。这个函数必须被调用使用锁 */
  2. static Elf *dup_elf (int fildes, Elf_Cmd cmd, Elf *ref) {
  3. struct Elf *result;
  4. if (fildes == -1)
  5. /* 允许用户传递-1作为新的文件 */
  6. fildes = ref->fildes;
  7. /* 如果它已经被断开(使用`elf_cntl`)我们不需要测试它 */
  8. else if (unlikely (ref->fildes != -1 && fildes != ref->fildes)) {
  9. __libelf_seterrno (ELF_E_FD_MISMATCH);
  10. return NULL;
  11. }
  12. /* 模式必须允许读。描述符通过一个与ELF_READ,ELF_C_WRITE与ELF_C_RDWR
  13. * 的命令进行创建。
  14. */
  15. if (unlikely (ref->cmd != ELF_C_READ
  16. && ref->cmd != ELF_C_READ_MMAP
  17. && ref->cmd != ELF_C_WRITE && ref->cmd != ELF_C_WRITE_MMAP
  18. && ref->cmd != ELF_C_RDWR && ref->cmd != ELF_C_RDWR_MMAP
  19. && ref->cmd != ELF_C_READ_MMAP_PRIVATE)) {
  20. __libelf_seterrno (ELF_E_INVALID_OP);
  21. return NULL;
  22. }
  23. /* 现在是区分读正常文件与库文件的时间点。正常的文件增加引用计数 */
  24. if (ref->kind != ELF_K_AR) {
  25. ++ref->ref_count;
  26. return ref;
  27. }
  28. /* 如果是一个库文件。我们必须创建一个库成员描述符的库文件描述符内部指针指向它。
  29. * 首先读取下一个成员的头 */
  30. if (ref->state.ar.elf_ar_hdr.ar_name == NULL
  31. && __libelf_next_arhdr_wrlock (ref) != 0)
  32. return NULL;
  33. /* 我们有所有我们需要下一个库成员的信息,现在我们创建它 */
  34. result = read_file (fildes, ref->state.ar.offset +
  35. sizeof (struct ar_hdr),
  36. ref->state.ar.elf_ar_hdr.ar_size, cmd, ref);
  37. /* 将新的文件描述符号,链接到库列表 */
  38. if (result != NULL) {
  39. result->next = ref->state.ar.children;
  40. ref->state.ar.children = result;
  41. }
  42. return result;
  43. }

上面的流程也很简单,涉及了两点一点就是如果文件是库文件,一种是elf。如果是elf如果ref存在则直接增加引用次数并返回,如果是库文件则需要调用__libelf_next_arhdr_wrlock获取下一个在库中的elf文件。随后则使用read_file进行读取。

让我们先忽略库文件,首先分析一下read_file函数。

  1. /* 打开文件读取。如果可能我们将尝试使用mmap() 映射文件 */
  2. static struct Elf *read_file (int fildes, /* 库文件的句柄 */
  3. off_t offset, /* 要读取文件的偏移 */
  4. size_t maxsize, /* 库文件最大长度 */
  5. Elf_Cmd cmd, /* 读取的使用的命令 */
  6. Elf *parent /* 父Elf的指针 */) {
  7. void *map_address = NULL;
  8. int use_mmap = (cmd == ELF_C_READ_MMAP || cmd == ELF_C_RDWR_MMAP
  9. || cmd == ELF_C_WRITE_MMAP
  10. || cmd == ELF_C_READ_MMAP_PRIVATE);
  11. /* 直接尝试使用内存映射 */
  12. if (use_mmap) {
  13. /* 父文件为空 <--- 库文件 */
  14. if (parent == NULL) {
  15. if (maxsize == ~((size_t) 0)) {
  16. /* 我们此时不知道文件有多大,现在决定它 */
  17. struct stat st;
  18. /* 获取文件最大长度 */
  19. if (fstat (fildes, &st) == 0
  20. && (sizeof (size_t) >= sizeof (st.st_size)
  21. || st.st_size <= ~((size_t) 0)))
  22. maxsize = (size_t) st.st_size;
  23. }
  24. /* 我们尝试映射父文件(库)*/
  25. map_address = mmap (NULL, maxsize,
  26. (cmd == ELF_C_READ_MMAP ? PROT_READ : PROT_READ|PROT_WRITE),
  27. cmd == ELF_C_READ_MMAP_PRIVATE ||
  28. cmd == ELF_C_READ_MMAP ? MAP_PRIVATE : MAP_SHARED,
  29. fildes, offset);
  30. if (map_address == MAP_FAILED)
  31. map_address = NULL;
  32. } else {
  33. /* 如果父文件已经被加载,使用它 */
  34. assert (maxsize != ~((size_t) 0));
  35. map_address = parent->map_address;
  36. }
  37. }
  38. /* 如果文件已经被映射则从映射读取 */
  39. if (map_address != NULL) {
  40. assert (map_address != MAP_FAILED);
  41. /* 读取文件并建立elf文件结构 */
  42. struct Elf *result = __libelf_read_mmaped_file (fildes,
  43. map_address, offset, maxsize, cmd, parent);
  44. /* 如果一些事情出错在为`unmap`做一些初始的事情期间 */
  45. if (result == NULL &&
  46. (parent == NULL || parent->map_address != map_address))
  47. munmap (map_address, maxsize);
  48. else if (parent == NULL)
  49. /* 记住已经映射过内存,如果父节点存在则直接使用父节点的flags */
  50. result->flags |= ELF_F_MMAPPED;
  51. return result;
  52. }
  53. /* 不映射文件直接从文件读取 */
  54. return read_unmmaped_file (fildes, offset, maxsize, cmd, parent);
  55. }

一系列的内存映射操作,映射后使用__libelf_read_mmaped_file进行直接读取映射,如果不使用映射则设置use_mmap为0值并最后使用read_unmmaped_file直接从文件中读取。
这两个函数大致差不多,那么直接看read_unmmaped_file即可。

  1. /* 不映射文件,直接读取 */
  2. static Elf *read_unmmaped_file (int fildes,
  3. off_t offset,
  4. size_t maxsize,
  5. Elf_Cmd cmd,
  6. Elf *parent) {
  7. /* 我们不得不找出这是一种什么样子的文件。我们处理ELF文件与库文件。
  8. * 为了找出是什么种类的文件,我们必须读取这些头。确定ELF文件则头有
  9. * EI_NIDENT个长度,但是我们不读取所有的ELF文件直到我们以后需要它。
  10. * 库文件的头有SARMAG个长度。读取这些最大的数量。
  11. */
  12. union {
  13. Elf64_Ehdr ehdr;
  14. unsigned char header[MAX (sizeof (Elf64_Ehdr), SARMAG)];
  15. } mem;
  16. /* 重新读取文件头 */
  17. ssize_t nread = pread_retry (fildes, mem.header,
  18. MIN (MAX (sizeof (Elf64_Ehdr), SARMAG), maxsize), offset);
  19. if (unlikely (nread == -1))
  20. return NULL;
  21. /* 确定类型 */
  22. Elf_Kind kind = determine_kind (mem.header, nread);
  23. switch (kind) {
  24. case ELF_K_AR:
  25. return file_read_ar (fildes, NULL, offset, maxsize, cmd, parent);
  26. case ELF_K_ELF:
  27. if ((size_t) nread >= (mem.header[EI_CLASS] == ELFCLASS32
  28. ? sizeof (Elf32_Ehdr) : sizeof (Elf64_Ehdr)))
  29. return file_read_elf (fildes, NULL, mem.header,
  30. offset, maxsize, cmd, parent);
  31. /* FALLTHROUGH */
  32. default:
  33. break;
  34. }
  35. /* 既然两种文件格式都不是,则直接分配一片内存使用 */
  36. return allocate_elf (fildes, NULL, offset, maxsize, cmd, parent,
  37. ELF_K_NONE, 0);
  38. }

上述代码中根据类型使用file_read_arfile_read_elf读取对应的文件。如果都不是这两种格式则使用allocate_elf分配一个空的elf结构。下面是重头戏,库文件的结构其实很简单,并非本库的重点,重点还是elf文件的读取。file_read_ar这里忽略分析,其实这个函数不难,本身库文件格式就是一个非常简单的格式。下面分析读取elf文件。

  1. static Elf *file_read_elf (int fildes,
  2. void *map_address,
  3. unsigned char *e_ident,
  4. off_t offset,
  5. size_t maxsize,
  6. Elf_Cmd cmd,
  7. Elf *parent) {
  8. /* 验证当前文件的类型 */
  9. if (unlikely ((e_ident[EI_CLASS] != ELFCLASS32
  10. && e_ident[EI_CLASS] != ELFCLASS64)
  11. || (e_ident[EI_DATA] != ELFDATA2LSB
  12. && e_ident[EI_DATA] != ELFDATA2MSB))) {
  13. __libelf_seterrno (ELF_E_INVALID_FILE);
  14. return NULL;
  15. }
  16. /* 决定节数量 */
  17. size_t scncnt = get_shnum (map_address, e_ident, fildes, offset, maxsize);
  18. if (scncnt == (size_t) -1l)
  19. return NULL;
  20. /* 分配elf结构内存 */
  21. Elf *elf = allocate_elf (fildes, map_address, offset, maxsize, cmd, parent,
  22. ELF_K_ELF, scncnt * sizeof (Elf_Scn));
  23. if (elf == NULL)
  24. return NULL;
  25. /* 节索引最大值 */
  26. elf->state.elf.scnincr = 10;
  27. /* 设置elf的位数类型 */
  28. elf->class = e_ident[EI_CLASS];
  29. /* 32位 */
  30. if (e_ident[EI_CLASS] == ELFCLASS32) {
  31. /* 如果当前的体系结果对其粒度不是充分支持的话,这个指针也许不能直接使用 */
  32. Elf32_Ehdr *ehdr = (Elf32_Ehdr *) ((char *) map_address + offset);
  33. /* 设置节计数 */
  34. assert ((unsigned int) scncnt == scncnt);
  35. elf->state.elf32.scns.cnt = elf->state.elf32.scns.max = scncnt;
  36. /* 32位的bin */
  37. if (map_address != NULL && e_ident[EI_DATA] == MY_ELFDATA
  38. && (ALLOW_UNALIGNED ||
  39. ((((uintptr_t) ehdr) & (__alignof__ (Elf32_Ehdr) - 1)) == 0
  40. && ((uintptr_t) ((char *) ehdr + ehdr->e_shoff)
  41. & (__alignof__ (Elf32_Shdr) - 1)) == 0
  42. && ((uintptr_t) ((char *) ehdr + ehdr->e_phoff)
  43. & (__alignof__ (Elf32_Phdr) - 1)) == 0))) {
  44. /* 我们能使用映射内存指针 */
  45. elf->state.elf32.ehdr = ehdr;/* elf头 */
  46. /* 设置节表 */
  47. elf->state.elf32.shdr =
  48. (Elf32_Shdr *) ((char *) ehdr + ehdr->e_shoff);
  49. if (ehdr->e_phnum > 0)
  50. elf->state.elf32.phdr =
  51. (Elf32_Phdr *) ((char *) ehdr +ehdr->e_phoff);
  52. /* 遍历节 */
  53. for (size_t cnt = 0; cnt < scncnt; ++cnt) {
  54. elf->state.elf32.scns.data[cnt].index = cnt;
  55. elf->state.elf32.scns.data[cnt].elf = elf;
  56. /* 节数据关联节表 */
  57. elf->state.elf32.scns.data[cnt].shdr.e32 =
  58. &elf->state.elf32.shdr[cnt];
  59. /* 设置节的数据内容,这里就是映射后的原始数据 */
  60. elf->state.elf32.scns.data[cnt].rawdata_base =
  61. elf->state.elf32.scns.data[cnt].data_base =
  62. ((char *) map_address + offset
  63. + elf->state.elf32.shdr[cnt].sh_offset);
  64. /* list表明是节链表 */
  65. elf->state.elf32.scns.data[cnt].list = &elf->state.elf32.scns;
  66. /* 如果当前节是符号表,则反向设置它所属字符串表节的符号索引 */
  67. if (elf->state.elf32.shdr[cnt].sh_type == SHT_SYMTAB_SHNDX
  68. && elf->state.elf32.shdr[cnt].sh_link < scncnt) {
  69. /* 进行字符串表的关联 */
  70. int sh_link = elf->state.elf32.shdr[cnt].sh_link;
  71. elf->state.elf32.scns.data[sh_link].shndx_index = cnt;
  72. }/* end if */
  73. /* 如果自身节的与符号表没有关联,则设定为-1 */
  74. if (elf->state.elf32.scns.data[cnt].shndx_index == 0)
  75. elf->state.elf32.scns.data[cnt].shndx_index = -1;
  76. }/* end for */
  77. } else {/* map_address == NULL,则直接从文件读取 */
  78. /* 复制elf头 */
  79. elf->state.elf32.ehdr = memcpy (&elf->state.elf32.ehdr_mem,
  80. e_ident,
  81. sizeof (Elf32_Ehdr));
  82. /* 字序转换 */
  83. if (e_ident[EI_DATA] != MY_ELFDATA) {
  84. CONVERT (elf->state.elf32.ehdr_mem.e_type);
  85. CONVERT (elf->state.elf32.ehdr_mem.e_machine);
  86. CONVERT (elf->state.elf32.ehdr_mem.e_version);
  87. CONVERT (elf->state.elf32.ehdr_mem.e_entry);
  88. CONVERT (elf->state.elf32.ehdr_mem.e_phoff);
  89. CONVERT (elf->state.elf32.ehdr_mem.e_shoff);
  90. CONVERT (elf->state.elf32.ehdr_mem.e_flags);
  91. CONVERT (elf->state.elf32.ehdr_mem.e_ehsize);
  92. CONVERT (elf->state.elf32.ehdr_mem.e_phentsize);
  93. CONVERT (elf->state.elf32.ehdr_mem.e_phnum);
  94. CONVERT (elf->state.elf32.ehdr_mem.e_shentsize);
  95. CONVERT (elf->state.elf32.ehdr_mem.e_shnum);
  96. CONVERT (elf->state.elf32.ehdr_mem.e_shstrndx);
  97. }
  98. for (size_t cnt = 0; cnt < scncnt; ++cnt) {
  99. elf->state.elf32.scns.data[cnt].index = cnt;
  100. elf->state.elf32.scns.data[cnt].elf = elf;
  101. elf->state.elf32.scns.data[cnt].list = &elf->state.elf32.scns;
  102. }
  103. }/* end else */
  104. elf->state.elf32.scns_last = &elf->state.elf32.scns;
  105. } else {/* is64 */
  106. /* 与32位逻辑相同 */
  107. }
  108. return elf;
  109. }

上面的代码,就是按照字节序转换读取elf文件头,值得一提的是对于节数据的填充,这里并非实际填充与转换将两个指针。

  1. elf->state.elf32.scns.data[cnt].rawdata_base =
  2. elf->state.elf32.scns.data[cnt].data_base =
  3. ((char *) map_address + offset
  4. + elf->state.elf32.shdr[cnt].sh_offset);

在后面要确切使用时才会按照字节序进行转换。

写入文件函数说明

这个库大多都是对文件目标的信息进行获取的。只有带有update字样的函数是写入函数。就是当你在修改了目标文件内容时进行使用,对齐更新,不过这个库有一个弊端就是写入是仅更新,也就是原先的节内容不能进行扩充,可以缩减。只有发生改变的节内容才进行更新。这有些局限性,不过按照给定节的偏移并不是那么容易。这样已经不错了。需要大量的修改文件内容的。需要自己重写组织结构。

这份库的历史很久,所以考虑的还是比较细的。写入函数考虑到了两种情况,一种是自己手动构建一个elf文件,另外一种是直接目标文件的修改。

这里从一个总入口elf_update函数聊起。

  1. off_t elf_update (Elf *elf, Elf_Cmd cmd) {
  2. size_t shnum;
  3. off_t size;
  4. int change_bo = 0;
  5. /* 命令不对头
  6. * 打开的命令必须带有写入权限 */
  7. if (cmd != ELF_C_NULL
  8. && cmd != ELF_C_WRITE
  9. && unlikely (cmd != ELF_C_WRITE_MMAP)) {
  10. __libelf_seterrno (ELF_E_INVALID_CMD);
  11. return -1;
  12. }
  13. if (elf == NULL)
  14. return -1;
  15. /* 类型检查 */
  16. if (elf->kind != ELF_K_ELF) {
  17. __libelf_seterrno (ELF_E_INVALID_HANDLE);
  18. return -1;
  19. }
  20. /* 读写 */
  21. rwlock_wrlock (elf->lock);
  22. /* 确定我们有一个ELF头 */
  23. if (elf->state.elf.ehdr == NULL) {
  24. __libelf_seterrno (ELF_E_WRONG_ORDER_EHDR);
  25. size = -1;
  26. goto out;
  27. }
  28. /* 确定节数量 */
  29. shnum = (elf->state.elf.scns_last->cnt == 0
  30. ? 0 : 1 + elf->state.elf.scns_last->data[elf->state.elf.scns_last->cnt - 1].index);
  31. /* 上面一堆操作最有用的就是的到了节数量,其余的都是在验证格式合法 */
  32. /* 随后就调用了updatenull_wrlock看名字就很有趣,翻译过来就是什么都没更新
  33. * 这个函数分为两个文件的实现32位版本与64位版本,单看32位即可
  34. */
  35. size = (elf->class == ELFCLASS32
  36. ? __elf32_updatenull_wrlock (elf, &change_bo, shnum)
  37. : __elf64_updatenull_wrlock (elf, &change_bo, shnum));
  38. /* 验证命令是否合规 */
  39. if (likely (size != -1)
  40. && (cmd == ELF_C_WRITE || cmd == ELF_C_WRITE_MMAP)) {
  41. /* 打开文件的权限必须有写权限 */
  42. if (elf->cmd != ELF_C_RDWR
  43. && elf->cmd != ELF_C_RDWR_MMAP
  44. && elf->cmd != ELF_C_WRITE
  45. && unlikely (elf->cmd != ELF_C_WRITE_MMAP)) {
  46. __libelf_seterrno (ELF_E_UPDATE_RO);
  47. size = -1;
  48. } else if (unlikely (elf->fildes == -1)) {/* 文件句柄无效 */
  49. __libelf_seterrno (ELF_E_FD_DISABLED);
  50. size = -1;
  51. } else/* 写入到文件中 */
  52. size = write_file (elf, size, change_bo, shnum);
  53. }
  54. out:
  55. rwlock_unlock (elf->lock);
  56. return size;
  57. }

elf32_updatenull函数如下:

这个函数其实最主要的作用就是在更新数据前,验证所有即将写入文件数据格式的合法性,将一些不正确的,改写为默认的值,如果是自己创建的elf结构体,则加入了验证长度环节。为了当以后的步骤中起码各种头结构中的信息与偏移在一个合法的范围内。说白了就是加强的验证。

  1. /* __elf32_updatenull_wrlock
  2. * elf ELF文件指针
  3. * change_bop 字节序是否发生改变
  4. * shnum 节数量
  5. */
  6. off_t internal_function
  7. __elfw2(LIBELFBITS,updatenull_wrlock) (Elf *elf,
  8. int *change_bop,
  9. size_t shnum) {
  10. ElfW2(LIBELFBITS,Ehdr) *ehdr;
  11. int changed = 0;
  12. int ehdr_flags = 0;
  13. /* __elf32_getehdr_wrlock
  14. * 获取ehdr头
  15. */
  16. ehdr = __elfw2(LIBELFBITS,getehdr_wrlock) (elf);
  17. /* 获取elf头的默认值 */
  18. if (ELFW(default_ehdr,LIBELFBITS) (elf, ehdr, shnum, change_bop) != 0)
  19. return -1;
  20. /* 获取elf头的长度 */
  21. off_t size = elf_typesize (LIBELFBITS, ELF_T_EHDR, 1);
  22. /* 设置程序头位置 */
  23. if (elf->state.ELFW(elf,LIBELFBITS).phdr == NULL
  24. && (ehdr->e_type == ET_EXEC || ehdr->e_type == ET_DYN
  25. || ehdr->e_type == ET_CORE))
  26. /* 获取程序头
  27. * __elf32_getphdr_wrlock
  28. */
  29. (void) __elfw2(LIBELFBITS,getphdr_wrlock) (elf);
  30. /* 获取到程序段头了 */
  31. if (elf->state.ELFW(elf,LIBELFBITS).phdr != NULL) {
  32. /* 只有应用程序,共享库,与CORE文件有程序头 */
  33. if (ehdr->e_type != ET_EXEC && ehdr->e_type != ET_DYN
  34. && unlikely (ehdr->e_type != ET_CORE)) {
  35. __libelf_seterrno (ELF_E_INVALID_PHDR);
  36. return -1;
  37. }
  38. if (elf->flags & ELF_F_LAYOUT) {
  39. /* 用户在支持填写e_phoff。使用它与e_phnum去决定最大长度扩展 */
  40. size = MAX ((size_t) size,
  41. ehdr->e_phoff
  42. + elf_typesize (LIBELFBITS, ELF_T_PHDR, ehdr->e_phnum));
  43. } else {
  44. /* 如果发生改变则更新 */
  45. update_if_changed (ehdr->e_phoff,
  46. elf_typesize (LIBELFBITS, ELF_T_EHDR, 1),
  47. ehdr_flags);
  48. /* 这里不需要对齐 */
  49. size += elf_typesize (LIBELFBITS, ELF_T_PHDR, ehdr->e_phnum);
  50. }
  51. }
  52. /* 节数量大于0 */
  53. if (shnum > 0) {
  54. Elf_ScnList *list;
  55. bool first = true;
  56. assert (elf->state.ELFW(elf,LIBELFBITS).scns.cnt > 0);
  57. /* 节数量大于0xFF00 */
  58. if (shnum >= SHN_LORESERVE) {
  59. /* 我们不得在节表中填充第0个索引节
  60. * elf32.scns.data[0]
  61. */
  62. Elf_Scn *scn0 = &elf->state.ELFW(elf,LIBELFBITS).scns.data[0];
  63. update_if_changed (scn0->shdr.ELFW(e,LIBELFBITS)->sh_size,
  64. shnum, scn0->shdr_flags);
  65. }
  66. /* 仔细检测所有的节并且找出它们有多大 */
  67. list = &elf->state.ELFW(elf,LIBELFBITS).scns;
  68. /* 加载所有的节头 */
  69. if (list->data[1].shdr.ELFW(e,LIBELFBITS) == NULL)
  70. (void) __elfw2(LIBELFBITS,getshdr_wrlock) (&list->data[1]);
  71. /* 遍历所有节表 */
  72. do {
  73. for (size_t cnt = first == true; cnt < list->cnt; ++cnt) {
  74. Elf_Scn *scn = &list->data[cnt];
  75. ElfW2(LIBELFBITS,Shdr) *shdr = scn->shdr.ELFW(e,LIBELFBITS);
  76. off_t offset = 0;
  77. assert (shdr != NULL);
  78. ElfW2(LIBELFBITS,Word) sh_entsize = shdr->sh_entsize;
  79. ElfW2(LIBELFBITS,Word) sh_align = shdr->sh_addralign ?: 1;
  80. /* 如果我们可以确定节的类型则设置sh_entsize的值 */
  81. switch (shdr->sh_type) {
  82. case SHT_SYMTAB:
  83. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_SYM, 1);
  84. break;
  85. case SHT_RELA:
  86. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_RELA, 1);
  87. break;
  88. case SHT_GROUP:
  89. /* 仅有重定位文件包含节组 */
  90. if (ehdr->e_type != ET_REL) {
  91. __libelf_seterrno (ELF_E_GROUP_NOT_REL);
  92. return -1;
  93. }
  94. /* FALLTHROUGH */
  95. case SHT_SYMTAB_SHNDX:
  96. sh_entsize = elf_typesize (32, ELF_T_WORD, 1);
  97. break;
  98. case SHT_HASH:
  99. sh_entsize = SH_ENTSIZE_HASH (ehdr);
  100. break;
  101. case SHT_DYNAMIC:
  102. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_DYN, 1);
  103. break;
  104. case SHT_REL:
  105. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_REL, 1);
  106. break;
  107. case SHT_DYNSYM:
  108. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_SYM, 1);
  109. break;
  110. case SHT_SUNW_move:
  111. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_MOVE, 1);
  112. break;
  113. case SHT_SUNW_syminfo:
  114. sh_entsize = elf_typesize (LIBELFBITS, ELF_T_SYMINFO, 1);
  115. break;
  116. default:
  117. break;
  118. }
  119. /* 如果节头包含错误的entry_size项则标记头为已经修改 */
  120. update_if_changed (shdr->sh_entsize,
  121. sh_entsize,
  122. scn->shdr_flags);
  123. if (scn->data_read == 0
  124. && __libelf_set_rawdata_wrlock (scn) != 0)
  125. return -1;
  126. /* 迭代所有的数据块 */
  127. if (list->data[cnt].data_list_rear != NULL) {
  128. Elf_Data_List *dl = &scn->data_list;
  129. while (dl != NULL) {
  130. Elf_Data *data = &dl->data.d;
  131. if (dl == &scn->data_list && data->d_buf == NULL
  132. && scn->rawdata.d.d_buf != NULL)
  133. data = &scn->rawdata.d;
  134. /* 数据版本非法 */
  135. if (unlikely (data->d_version == EV_NONE)
  136. || unlikely (data->d_version >= EV_NUM)) {
  137. __libelf_seterrno (ELF_E_UNKNOWN_VERSION);
  138. return -1;
  139. }
  140. /* 检验数据是否对齐 */
  141. if (unlikely (! powerof2 (data->d_align))) {
  142. __libelf_seterrno (ELF_E_INVALID_ALIGN);
  143. return -1;
  144. }
  145. /* 节对齐粒度 */
  146. sh_align = MAX (sh_align, data->d_align);
  147. if (elf->flags & ELF_F_LAYOUT) {
  148. /* 用户指定偏移与长度,所以我们不得不检测这个块
  149. * 是否在节允许范围内
  150. */
  151. if (unlikely ((GElf_Word) (data->d_off
  152. + data->d_size)
  153. > shdr->sh_size)) {
  154. __libelf_seterrno (ELF_E_SECTION_TOO_SMALL);
  155. return -1;
  156. }
  157. } else {
  158. /* 决定是否填充一些杂物 */
  159. offset = ((offset + data->d_align - 1)
  160. & ~(data->d_align - 1));
  161. update_if_changed (data->d_off, offset, changed);
  162. offset += data->d_size;
  163. }
  164. /* 下一个数据块 */
  165. dl = dl->next;
  166. }
  167. } else
  168. /* 获取从原始数据(raw data)的节大小 */
  169. offset += scn->rawdata.d.d_size;
  170. if (elf->flags & ELF_F_LAYOUT) {
  171. size = MAX ((GElf_Word) size,
  172. shdr->sh_offset
  173. + (shdr->sh_type != SHT_NOBITS
  174. ? shdr->sh_size : 0));
  175. /* 对齐粒度必须是2的幂次方。这是ELF标准需要的。我们这里是附加测试 */
  176. if (unlikely (! powerof2 (shdr->sh_addralign))
  177. || unlikely (shdr->sh_addralign < sh_align)) {
  178. __libelf_seterrno (ELF_E_INVALID_ALIGN);
  179. return -1;
  180. }
  181. } else {
  182. /* 设置这个节的对齐粒度 */
  183. update_if_changed (shdr->sh_addralign, sh_align,
  184. scn->shdr_flags);
  185. /* 获取对齐粒度后的长度 */
  186. size = (size + sh_align - 1) & ~(sh_align - 1);
  187. int offset_changed = 0;
  188. update_if_changed (shdr->sh_offset, (GElf_Word) size,
  189. offset_changed);
  190. changed |= offset_changed;
  191. if (offset_changed && scn->data_list_rear == NULL) {
  192. /* 节在文件中的位置发生改变。创建节的数据列表 */
  193. if (__elf_getdata_rdlock (scn, NULL) == NULL)
  194. return -1;
  195. }
  196. /* 检查节长度是否正确 */
  197. update_if_changed (shdr->sh_size, (GElf_Word) offset,
  198. changed);
  199. if (shdr->sh_type != SHT_NOBITS)
  200. size += offset;
  201. /* 节的标志发生改变 */
  202. scn->flags |= changed;
  203. }
  204. /* 检查节的长度是否是entry长度的倍数 */
  205. if (shdr->sh_entsize != 0
  206. && unlikely (shdr->sh_size % shdr->sh_entsize != 0)
  207. && (elf->flags & ELF_F_PERMISSIVE) == 0) {
  208. __libelf_seterrno (ELF_E_INVALID_SHENTSIZE);
  209. return -1;
  210. }
  211. }
  212. assert (list->next == NULL || list->cnt == list->max);
  213. first = false;
  214. } while ((list = list->next) != NULL);
  215. /* 保存节信息 */
  216. if (elf->flags & ELF_F_LAYOUT) {
  217. /* 支持用户自行填充e_phoff。使用它与e_phnum来决定最大的扩展 */
  218. size = MAX ((GElf_Word) size,
  219. (ehdr->e_shoff
  220. + (elf_typesize (LIBELFBITS, ELF_T_SHDR, shnum))));
  221. } else {
  222. /* 对齐节头表
  223. * 是,我们使用`sizeof`并不是`__alignof__`直到我们不想严格使用
  224. * 体系架构中指定的对齐粒度
  225. */
  226. #define SHDR_ALIGN sizeof (ElfW2(LIBELFBITS,Off))
  227. size = (size + SHDR_ALIGN - 1) & ~(SHDR_ALIGN - 1);
  228. update_if_changed (ehdr->e_shoff, (GElf_Word) size, elf->flags);
  229. update_if_changed (ehdr->e_shentsize,
  230. elf_typesize (LIBELFBITS, ELF_T_SHDR, 1),
  231. ehdr_flags);
  232. /* 核算节头长度 */
  233. size += elf_typesize (LIBELFBITS, ELF_T_SHDR, shnum);
  234. }
  235. }
  236. /* 设置标志 */
  237. elf->state.ELFW(elf,LIBELFBITS).ehdr_flags |= ehdr_flags;
  238. return size;
  239. }

上面有一个update_if_changed函数,其实这是一个宏,它的作用就是对比第一个参数与第二个参数的值,如果两个不一样,则将第一个参数的值设置为第二个参数的值,然后将后面的标志变量设置上DIRTY标志位,表明经过外部修改了。

write_file

这里是实现写入的入口,其实它也是一个接口函数,主要的实现是__elf32_updatemmap__elf32_updatefile两个函数。一个是当文件使用映射时,一个是直接以文件句柄操作时的更新方式,内部流程大致相同。

  1. static off_t
  2. write_file (Elf *elf,/* Elf结构指针 */
  3. off_t size,/* 要写入的长度 */
  4. int change_bo,/* 是否发生改变 */
  5. size_t shnum/* 节数量 */) {
  6. /* ELF的位数 */
  7. int class = elf->class;
  8. /* 获取文件状态 */
  9. struct stat st;
  10. if (unlikely (fstat (elf->fildes, &st) != 0)) {
  11. __libelf_seterrno (ELF_E_WRITE_ERROR);
  12. return -1;
  13. }
  14. /* 验证参数size是否合规 */
  15. if (elf->parent == NULL && (elf->maximum_size == ~((size_t) 0)
  16. || (size_t) size > elf->maximum_size)
  17. && unlikely (ftruncate (elf->fildes, size) != 0)) {
  18. __libelf_seterrno (ELF_E_WRITE_ERROR);
  19. return -1;
  20. }
  21. /* 如果没有完成则尝试映射文件 */
  22. if (elf->map_address == NULL && elf->cmd == ELF_C_WRITE_MMAP) {
  23. #if _MUDFLAP
  24. /* Mudflap doesn't grok that our mmap'd data is ok. */
  25. #else
  26. /* 映射文件 */
  27. elf->map_address = mmap (NULL, size, PROT_READ | PROT_WRITE,
  28. MAP_SHARED, elf->fildes, 0);
  29. if (unlikely (elf->map_address == MAP_FAILED))
  30. elf->map_address = NULL;
  31. #endif
  32. }
  33. /* 文件已经被映射 */
  34. if (elf->map_address != NULL) {
  35. /* 按照位数更新映射 */
  36. if ((class == ELFCLASS32
  37. ? __elf32_updatemmap (elf, change_bo, shnum)
  38. : __elf64_updatemmap (elf, change_bo, shnum)) != 0)
  39. size = -1;
  40. } else {
  41. /* 文件没有被映射,则直接更新文件 */
  42. if ((class == ELFCLASS32
  43. ? __elf32_updatefile (elf, change_bo, shnum)
  44. : __elf64_updatefile (elf, change_bo, shnum)) != 0)
  45. size = -1;
  46. }
  47. if (size != -1
  48. && elf->parent == NULL
  49. && elf->maximum_size != ~((size_t) 0)
  50. && (size_t) size < elf->maximum_size
  51. && unlikely (ftruncate (elf->fildes, size) != 0)) {
  52. __libelf_seterrno (ELF_E_WRITE_ERROR);
  53. size = -1;
  54. }
  55. /* POSIX说明'ftruncate'与'write'也许会清除S_ISUID与S_ISGID位。因此我们要
  56. * 在调用这两个函数后写回去。 */
  57. if (size != -1
  58. && unlikely (st.st_mode & (S_ISUID | S_ISGID))
  59. && unlikely (fchmod (elf->fildes, st.st_mode) != 0)) {
  60. __libelf_seterrno (ELF_E_WRITE_ERROR);
  61. size = -1;
  62. }
  63. /* 更新尺寸 */
  64. if (size != -1 && elf->parent == NULL)
  65. elf->maximum_size = size;
  66. return size;
  67. }

elf32_updatefileelf32_updatemmap两个实现大同小异,代码太长了,这里不进行分析了。主要就是将elf结构中的内容,按照结构输出到文件中。需要注意的是,对于节内容的更新,它是仅更新修改过的节内容,也就是说,不修改的节内容还在原来文件或者内存映射该存在的地方。这就是说,如果要修改一个elf文件时注意节的范围,以免越界。

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注