Fix copyright notices
[deliverable/binutils-gdb.git] / gas / config / tc-i386.h
1 /* tc-i386.h -- Header file for tc-i386.c
2 Copyright 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
3 2001
4 Free Software Foundation, Inc.
5
6 This file is part of GAS, the GNU Assembler.
7
8 GAS is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
12
13 GAS is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with GAS; see the file COPYING. If not, write to the Free
20 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
21 02111-1307, USA. */
22
23 #ifndef TC_I386
24 #define TC_I386 1
25
26 #ifdef ANSI_PROTOTYPES
27 struct fix;
28 #endif
29
30 #define TARGET_BYTES_BIG_ENDIAN 0
31
32 #ifdef TE_LYNX
33 #define TARGET_FORMAT "coff-i386-lynx"
34 #endif
35
36 #ifdef BFD_ASSEMBLER
37 /* This is used to determine relocation types in tc-i386.c. The first
38 parameter is the current relocation type, the second one is the desired
39 type. The idea is that if the original type is already some kind of PIC
40 relocation, we leave it alone, otherwise we give it the desired type */
41
42 #define tc_fix_adjustable(X) tc_i386_fix_adjustable(X)
43 extern int tc_i386_fix_adjustable PARAMS ((struct fix *));
44
45 #if (defined (OBJ_MAYBE_ELF) || defined (OBJ_ELF) || defined (OBJ_MAYBE_COFF) || defined (OBJ_COFF)) && !defined (TE_PE)
46 /* This arranges for gas/write.c to not apply a relocation if
47 tc_fix_adjustable() says it is not adjustable.
48 The "! symbol_used_in_reloc_p" test is there specifically to cover
49 the case of non-global symbols in linkonce sections. It's the
50 generally correct thing to do though; If a reloc is going to be
51 emitted against a symbol then we don't want to adjust the fixup by
52 applying the reloc during assembly. The reloc will be applied by
53 the linker during final link. */
54 #define TC_FIX_ADJUSTABLE(fixP) \
55 (! symbol_used_in_reloc_p ((fixP)->fx_addsy) && tc_fix_adjustable (fixP))
56 #endif
57
58 /* This expression evaluates to false if the relocation is for a local object
59 for which we still want to do the relocation at runtime. True if we
60 are willing to perform this relocation while building the .o file.
61 This is only used for pcrel relocations, so GOTOFF does not need to be
62 checked here. I am not sure if some of the others are ever used with
63 pcrel, but it is easier to be safe than sorry. */
64
65 #define TC_RELOC_RTSYM_LOC_FIXUP(FIX) \
66 ((FIX)->fx_r_type != BFD_RELOC_386_PLT32 \
67 && (FIX)->fx_r_type != BFD_RELOC_386_GOT32 \
68 && (FIX)->fx_r_type != BFD_RELOC_386_GOTPC \
69 && ((FIX)->fx_addsy == NULL \
70 || (! S_IS_EXTERNAL ((FIX)->fx_addsy) \
71 && ! S_IS_WEAK ((FIX)->fx_addsy) \
72 && S_IS_DEFINED ((FIX)->fx_addsy) \
73 && ! S_IS_COMMON ((FIX)->fx_addsy))))
74
75 #define TARGET_ARCH bfd_arch_i386
76 #define TARGET_MACH (i386_mach ())
77 extern unsigned long i386_mach PARAMS ((void));
78
79 #ifdef TE_FreeBSD
80 #define AOUT_TARGET_FORMAT "a.out-i386-freebsd"
81 #endif
82 #ifdef TE_NetBSD
83 #define AOUT_TARGET_FORMAT "a.out-i386-netbsd"
84 #endif
85 #ifdef TE_386BSD
86 #define AOUT_TARGET_FORMAT "a.out-i386-bsd"
87 #endif
88 #ifdef TE_LINUX
89 #define AOUT_TARGET_FORMAT "a.out-i386-linux"
90 #endif
91 #ifdef TE_Mach
92 #define AOUT_TARGET_FORMAT "a.out-mach3"
93 #endif
94 #ifdef TE_DYNIX
95 #define AOUT_TARGET_FORMAT "a.out-i386-dynix"
96 #endif
97 #ifndef AOUT_TARGET_FORMAT
98 #define AOUT_TARGET_FORMAT "a.out-i386"
99 #endif
100
101 #if ((defined (OBJ_MAYBE_COFF) && defined (OBJ_MAYBE_AOUT)) \
102 || defined (OBJ_ELF) || defined (OBJ_MAYBE_ELF))
103 extern const char *i386_target_format PARAMS ((void));
104 #define TARGET_FORMAT i386_target_format ()
105 #else
106 #ifdef OBJ_ELF
107 #define TARGET_FORMAT "elf32-i386"
108 #endif
109 #ifdef OBJ_AOUT
110 #define TARGET_FORMAT AOUT_TARGET_FORMAT
111 #endif
112 #endif
113
114 #else /* ! BFD_ASSEMBLER */
115
116 /* COFF STUFF */
117
118 #define COFF_MAGIC I386MAGIC
119 #define BFD_ARCH bfd_arch_i386
120 #define COFF_FLAGS F_AR32WR
121 #define TC_COUNT_RELOC(x) ((x)->fx_addsy || (x)->fx_r_type==7)
122 #define TC_COFF_FIX2RTYPE(fixP) tc_coff_fix2rtype(fixP)
123 extern short tc_coff_fix2rtype PARAMS ((struct fix *));
124 #define TC_COFF_SIZEMACHDEP(frag) tc_coff_sizemachdep(frag)
125 extern int tc_coff_sizemachdep PARAMS ((fragS *frag));
126
127 #ifdef TE_GO32
128 /* DJGPP now expects some sections to be 2**4 aligned. */
129 #define SUB_SEGMENT_ALIGN(SEG) \
130 ((strcmp (obj_segment_name (SEG), ".text") == 0 \
131 || strcmp (obj_segment_name (SEG), ".data") == 0 \
132 || strcmp (obj_segment_name (SEG), ".bss") == 0 \
133 || strncmp (obj_segment_name (SEG), ".gnu.linkonce.t", 15) == 0 \
134 || strncmp (obj_segment_name (SEG), ".gnu.linkonce.d", 15) == 0 \
135 || strncmp (obj_segment_name (SEG), ".gnu.linkonce.r", 15) == 0) \
136 ? 4 \
137 : 2)
138 #else
139 #define SUB_SEGMENT_ALIGN(SEG) 2
140 #endif
141
142 #define TC_RVA_RELOC 7
143 /* Need this for PIC relocations */
144 #define NEED_FX_R_TYPE
145
146 #ifdef TE_386BSD
147 /* The BSDI linker apparently rejects objects with a machine type of
148 M_386 (100). */
149 #define AOUT_MACHTYPE 0
150 #else
151 #define AOUT_MACHTYPE 100
152 #endif
153
154 #undef REVERSE_SORT_RELOCS
155
156 #endif /* ! BFD_ASSEMBLER */
157
158 #define TC_FORCE_RELOCATION(fixp) tc_i386_force_relocation(fixp)
159 extern int tc_i386_force_relocation PARAMS ((struct fix *));
160
161 #ifdef BFD_ASSEMBLER
162 #define NO_RELOC BFD_RELOC_NONE
163 #else
164 #define NO_RELOC 0
165 #endif
166 #define tc_coff_symbol_emit_hook(a) ; /* not used */
167
168 #ifndef BFD_ASSEMBLER
169 #ifndef OBJ_AOUT
170 #ifndef TE_PE
171 #ifndef TE_GO32
172 /* Local labels starts with .L */
173 #define LOCAL_LABEL(name) (name[0] == '.' \
174 && (name[1] == 'L' || name[1] == 'X' || name[1] == '.'))
175 #endif
176 #endif
177 #endif
178 #endif
179
180 #define LOCAL_LABELS_FB 1
181
182 #define tc_aout_pre_write_hook(x) {;} /* not used */
183 #define tc_crawl_symbol_chain(a) {;} /* not used */
184 #define tc_headers_hook(a) {;} /* not used */
185
186 extern const char extra_symbol_chars[];
187 #define tc_symbol_chars extra_symbol_chars
188
189 #define MAX_OPERANDS 3 /* max operands per insn */
190 #define MAX_IMMEDIATE_OPERANDS 2/* max immediates per insn (lcall, ljmp) */
191 #define MAX_MEMORY_OPERANDS 2 /* max memory refs per insn (string ops) */
192
193 /* Prefixes will be emitted in the order defined below.
194 WAIT_PREFIX must be the first prefix since FWAIT is really is an
195 instruction, and so must come before any prefixes. */
196 #define WAIT_PREFIX 0
197 #define LOCKREP_PREFIX 1
198 #define ADDR_PREFIX 2
199 #define DATA_PREFIX 3
200 #define SEG_PREFIX 4
201 #define REX_PREFIX 5 /* must come last. */
202 #define MAX_PREFIXES 6 /* max prefixes per opcode */
203
204 /* we define the syntax here (modulo base,index,scale syntax) */
205 #define REGISTER_PREFIX '%'
206 #define IMMEDIATE_PREFIX '$'
207 #define ABSOLUTE_PREFIX '*'
208
209 #define TWO_BYTE_OPCODE_ESCAPE 0x0f
210 #define NOP_OPCODE (char) 0x90
211
212 /* register numbers */
213 #define EBP_REG_NUM 5
214 #define ESP_REG_NUM 4
215
216 /* modrm_byte.regmem for twobyte escape */
217 #define ESCAPE_TO_TWO_BYTE_ADDRESSING ESP_REG_NUM
218 /* index_base_byte.index for no index register addressing */
219 #define NO_INDEX_REGISTER ESP_REG_NUM
220 /* index_base_byte.base for no base register addressing */
221 #define NO_BASE_REGISTER EBP_REG_NUM
222 #define NO_BASE_REGISTER_16 6
223
224 /* these are the instruction mnemonic suffixes. */
225 #define WORD_MNEM_SUFFIX 'w'
226 #define BYTE_MNEM_SUFFIX 'b'
227 #define SHORT_MNEM_SUFFIX 's'
228 #define LONG_MNEM_SUFFIX 'l'
229 #define QWORD_MNEM_SUFFIX 'q'
230 /* Intel Syntax */
231 #define LONG_DOUBLE_MNEM_SUFFIX 'x'
232
233 /* modrm.mode = REGMEM_FIELD_HAS_REG when a register is in there */
234 #define REGMEM_FIELD_HAS_REG 0x3/* always = 0x3 */
235 #define REGMEM_FIELD_HAS_MEM (~REGMEM_FIELD_HAS_REG)
236
237 #define END_OF_INSN '\0'
238
239 /* Intel Syntax */
240 /* Values 0-4 map onto scale factor */
241 #define BYTE_PTR 0
242 #define WORD_PTR 1
243 #define DWORD_PTR 2
244 #define QWORD_PTR 3
245 #define XWORD_PTR 4
246 #define SHORT 5
247 #define OFFSET_FLAT 6
248 #define FLAT 7
249 #define NONE_FOUND 8
250
251 typedef struct
252 {
253 /* instruction name sans width suffix ("mov" for movl insns) */
254 char *name;
255
256 /* how many operands */
257 unsigned int operands;
258
259 /* base_opcode is the fundamental opcode byte without optional
260 prefix(es). */
261 unsigned int base_opcode;
262
263 /* extension_opcode is the 3 bit extension for group <n> insns.
264 This field is also used to store the 8-bit opcode suffix for the
265 AMD 3DNow! instructions.
266 If this template has no extension opcode (the usual case) use None */
267 unsigned int extension_opcode;
268 #define None 0xffff /* If no extension_opcode is possible. */
269
270 /* cpu feature flags */
271 unsigned int cpu_flags;
272 #define Cpu086 0x1 /* Any old cpu will do, 0 does the same */
273 #define Cpu186 0x2 /* i186 or better required */
274 #define Cpu286 0x4 /* i286 or better required */
275 #define Cpu386 0x8 /* i386 or better required */
276 #define Cpu486 0x10 /* i486 or better required */
277 #define Cpu586 0x20 /* i585 or better required */
278 #define Cpu686 0x40 /* i686 or better required */
279 #define CpuP4 0x80 /* Pentium4 or better required */
280 #define CpuK6 0x100 /* AMD K6 or better required*/
281 #define CpuAthlon 0x200 /* AMD Athlon or better required*/
282 #define CpuSledgehammer 0x400 /* Sledgehammer or better required */
283 #define CpuMMX 0x800 /* MMX support required */
284 #define CpuSSE 0x1000 /* Streaming SIMD extensions required */
285 #define CpuSSE2 0x2000 /* Streaming SIMD extensions 2 required */
286 #define Cpu3dnow 0x4000 /* 3dnow! support required */
287 #define CpuUnknown 0x8000 /* The CPU is unknown, be on the safe side. */
288
289 /* These flags are set by gas depending on the flag_code. */
290 #define Cpu64 0x4000000 /* 64bit support required */
291 #define CpuNo64 0x8000000 /* Not supported in the 64bit mode */
292
293 /* The default value for unknown CPUs - enable all features to avoid problems. */
294 #define CpuUnknownFlags (Cpu086|Cpu186|Cpu286|Cpu386|Cpu486|Cpu586|Cpu686|CpuP4|CpuSledgehammer|CpuMMX|CpuSSE|CpuSSE2|Cpu3dnow|CpuK6|CpuAthlon)
295
296 /* the bits in opcode_modifier are used to generate the final opcode from
297 the base_opcode. These bits also are used to detect alternate forms of
298 the same instruction */
299 unsigned int opcode_modifier;
300
301 /* opcode_modifier bits: */
302 #define W 0x1 /* set if operands can be words or dwords
303 encoded the canonical way */
304 #define D 0x2 /* D = 0 if Reg --> Regmem;
305 D = 1 if Regmem --> Reg: MUST BE 0x2 */
306 #define Modrm 0x4
307 #define FloatR 0x8 /* src/dest swap for floats: MUST BE 0x8 */
308 #define ShortForm 0x10 /* register is in low 3 bits of opcode */
309 #define FloatMF 0x20 /* FP insn memory format bit, sized by 0x4 */
310 #define Jump 0x40 /* special case for jump insns. */
311 #define JumpDword 0x80 /* call and jump */
312 #define JumpByte 0x100 /* loop and jecxz */
313 #define JumpInterSegment 0x200 /* special case for intersegment leaps/calls */
314 #define FloatD 0x400 /* direction for float insns: MUST BE 0x400 */
315 #define Seg2ShortForm 0x800 /* encoding of load segment reg insns */
316 #define Seg3ShortForm 0x1000 /* fs/gs segment register insns. */
317 #define Size16 0x2000 /* needs size prefix if in 32-bit mode */
318 #define Size32 0x4000 /* needs size prefix if in 16-bit mode */
319 #define Size64 0x8000 /* needs size prefix if in 16-bit mode */
320 #define IgnoreSize 0x10000 /* instruction ignores operand size prefix */
321 #define DefaultSize 0x20000 /* default insn size depends on mode */
322 #define No_bSuf 0x40000 /* b suffix on instruction illegal */
323 #define No_wSuf 0x80000 /* w suffix on instruction illegal */
324 #define No_lSuf 0x100000 /* l suffix on instruction illegal */
325 #define No_sSuf 0x200000 /* s suffix on instruction illegal */
326 #define No_qSuf 0x400000 /* q suffix on instruction illegal */
327 #define No_xSuf 0x800000 /* x suffix on instruction illegal */
328 #define FWait 0x1000000 /* instruction needs FWAIT */
329 #define IsString 0x2000000 /* quick test for string instructions */
330 #define regKludge 0x4000000 /* fake an extra reg operand for clr, imul */
331 #define IsPrefix 0x8000000 /* opcode is a prefix */
332 #define ImmExt 0x10000000 /* instruction has extension in 8 bit imm */
333 #define NoRex64 0x20000000 /* instruction don't need Rex64 prefix. */
334 #define Rex64 0x40000000 /* instruction require Rex64 prefix. */
335 #define Ugh 0x80000000 /* deprecated fp insn, gets a warning */
336
337 /* operand_types[i] describes the type of operand i. This is made
338 by OR'ing together all of the possible type masks. (e.g.
339 'operand_types[i] = Reg|Imm' specifies that operand i can be
340 either a register or an immediate operand. */
341 unsigned int operand_types[3];
342
343 /* operand_types[i] bits */
344 /* register */
345 #define Reg8 0x1 /* 8 bit reg */
346 #define Reg16 0x2 /* 16 bit reg */
347 #define Reg32 0x4 /* 32 bit reg */
348 #define Reg64 0x8 /* 64 bit reg */
349 /* immediate */
350 #define Imm8 0x10 /* 8 bit immediate */
351 #define Imm8S 0x20 /* 8 bit immediate sign extended */
352 #define Imm16 0x40 /* 16 bit immediate */
353 #define Imm32 0x80 /* 32 bit immediate */
354 #define Imm32S 0x100 /* 32 bit immediate sign extended */
355 #define Imm64 0x200 /* 64 bit immediate */
356 #define Imm1 0x400 /* 1 bit immediate */
357 /* memory */
358 #define BaseIndex 0x800
359 /* Disp8,16,32 are used in different ways, depending on the
360 instruction. For jumps, they specify the size of the PC relative
361 displacement, for baseindex type instructions, they specify the
362 size of the offset relative to the base register, and for memory
363 offset instructions such as `mov 1234,%al' they specify the size of
364 the offset relative to the segment base. */
365 #define Disp8 0x1000 /* 8 bit displacement */
366 #define Disp16 0x2000 /* 16 bit displacement */
367 #define Disp32 0x4000 /* 32 bit displacement */
368 #define Disp32S 0x8000 /* 32 bit signed displacement */
369 #define Disp64 0x10000 /* 64 bit displacement */
370 /* specials */
371 #define InOutPortReg 0x20000 /* register to hold in/out port addr = dx */
372 #define ShiftCount 0x40000 /* register to hold shift cound = cl */
373 #define Control 0x80000 /* Control register */
374 #define Debug 0x100000 /* Debug register */
375 #define Test 0x200000 /* Test register */
376 #define FloatReg 0x400000 /* Float register */
377 #define FloatAcc 0x800000 /* Float stack top %st(0) */
378 #define SReg2 0x1000000 /* 2 bit segment register */
379 #define SReg3 0x2000000 /* 3 bit segment register */
380 #define Acc 0x4000000 /* Accumulator %al or %ax or %eax */
381 #define JumpAbsolute 0x8000000
382 #define RegMMX 0x10000000 /* MMX register */
383 #define RegXMM 0x20000000 /* XMM registers in PIII */
384 #define EsSeg 0x40000000 /* String insn operand with fixed es segment */
385
386 /* InvMem is for instructions with a modrm byte that only allow a
387 general register encoding in the i.tm.mode and i.tm.regmem fields,
388 eg. control reg moves. They really ought to support a memory form,
389 but don't, so we add an InvMem flag to the register operand to
390 indicate that it should be encoded in the i.tm.regmem field. */
391 #define InvMem 0x80000000
392
393 #define Reg (Reg8|Reg16|Reg32|Reg64) /* gen'l register */
394 #define WordReg (Reg16|Reg32|Reg64)
395 #define ImplicitRegister (InOutPortReg|ShiftCount|Acc|FloatAcc)
396 #define Imm (Imm8|Imm8S|Imm16|Imm32S|Imm32|Imm64) /* gen'l immediate */
397 #define EncImm (Imm8|Imm16|Imm32|Imm32S) /* Encodable gen'l immediate */
398 #define Disp (Disp8|Disp16|Disp32|Disp32S|Disp64) /* General displacement */
399 #define AnyMem (Disp8|Disp16|Disp32|Disp32S|BaseIndex|InvMem) /* General memory */
400 /* The following aliases are defined because the opcode table
401 carefully specifies the allowed memory types for each instruction.
402 At the moment we can only tell a memory reference size by the
403 instruction suffix, so there's not much point in defining Mem8,
404 Mem16, Mem32 and Mem64 opcode modifiers - We might as well just use
405 the suffix directly to check memory operands. */
406 #define LLongMem AnyMem /* 64 bits (or more) */
407 #define LongMem AnyMem /* 32 bit memory ref */
408 #define ShortMem AnyMem /* 16 bit memory ref */
409 #define WordMem AnyMem /* 16 or 32 bit memory ref */
410 #define ByteMem AnyMem /* 8 bit memory ref */
411 }
412 template;
413
414 /*
415 'templates' is for grouping together 'template' structures for opcodes
416 of the same name. This is only used for storing the insns in the grand
417 ole hash table of insns.
418 The templates themselves start at START and range up to (but not including)
419 END.
420 */
421 typedef struct
422 {
423 const template *start;
424 const template *end;
425 }
426 templates;
427
428 /* these are for register name --> number & type hash lookup */
429 typedef struct
430 {
431 char *reg_name;
432 unsigned int reg_type;
433 unsigned int reg_flags;
434 #define RegRex 0x1 /* Extended register. */
435 #define RegRex64 0x2 /* Extended 8 bit register. */
436 unsigned int reg_num;
437 }
438 reg_entry;
439
440 typedef struct
441 {
442 char *seg_name;
443 unsigned int seg_prefix;
444 }
445 seg_entry;
446
447 /* 386 operand encoding bytes: see 386 book for details of this. */
448 typedef struct
449 {
450 unsigned int regmem; /* codes register or memory operand */
451 unsigned int reg; /* codes register operand (or extended opcode) */
452 unsigned int mode; /* how to interpret regmem & reg */
453 }
454 modrm_byte;
455
456 /* x86-64 extension prefix. */
457 typedef struct
458 {
459 unsigned int mode64;
460 unsigned int extX; /* Used to extend modrm reg field. */
461 unsigned int extY; /* Used to extend SIB index field. */
462 unsigned int extZ; /* Used to extend modrm reg/mem, SIB base, modrm base fields. */
463 unsigned int empty; /* Used to old-style byte registers to new style. */
464 }
465 rex_byte;
466
467 /* 386 opcode byte to code indirect addressing. */
468 typedef struct
469 {
470 unsigned base;
471 unsigned index;
472 unsigned scale;
473 }
474 sib_byte;
475
476 /* x86 arch names and features */
477 typedef struct
478 {
479 const char *name; /* arch name */
480 unsigned int flags; /* cpu feature flags */
481 }
482 arch_entry;
483
484 /* The name of the global offset table generated by the compiler. Allow
485 this to be overridden if need be. */
486 #ifndef GLOBAL_OFFSET_TABLE_NAME
487 #define GLOBAL_OFFSET_TABLE_NAME "_GLOBAL_OFFSET_TABLE_"
488 #endif
489
490 #ifdef BFD_ASSEMBLER
491 void i386_validate_fix PARAMS ((struct fix *));
492 #define TC_VALIDATE_FIX(FIXP,SEGTYPE,SKIP) i386_validate_fix(FIXP)
493 #endif
494
495 #endif /* TC_I386 */
496
497 #define md_operand(x)
498
499 extern const struct relax_type md_relax_table[];
500 #define TC_GENERIC_RELAX_TABLE md_relax_table
501
502 #define md_do_align(n, fill, len, max, around) \
503 if ((n) && !need_pass_2 \
504 && (!(fill) || ((char)*(fill) == (char)0x90 && (len) == 1)) \
505 && subseg_text_p (now_seg)) \
506 { \
507 frag_align_code ((n), (max)); \
508 goto around; \
509 }
510
511 #define MAX_MEM_FOR_RS_ALIGN_CODE 15
512
513 extern void i386_align_code PARAMS ((fragS *, int));
514
515 #define HANDLE_ALIGN(fragP) \
516 if (fragP->fr_type == rs_align_code) \
517 i386_align_code (fragP, (fragP->fr_next->fr_address \
518 - fragP->fr_address \
519 - fragP->fr_fix));
520
521 /* call md_apply_fix3 with segment instead of md_apply_fix */
522 #define MD_APPLY_FIX3
523
524 void i386_print_statistics PARAMS ((FILE *));
525 #define tc_print_statistics i386_print_statistics
526
527 #define md_number_to_chars number_to_chars_littleendian
528
529 #ifdef SCO_ELF
530 #define tc_init_after_args() sco_id ()
531 extern void sco_id PARAMS ((void));
532 #endif
533
534 #define DIFF_EXPR_OK /* foo-. gets turned into PC relative relocs */
This page took 0.042602 seconds and 4 git commands to generate.