4 * create git identifier lines of the form "name <email> date"
6 * Copyright (C) 2005 Linus Torvalds
11 static struct strbuf git_default_name
= STRBUF_INIT
;
12 static struct strbuf git_default_email
= STRBUF_INIT
;
13 static struct strbuf git_default_date
= STRBUF_INIT
;
14 static struct strbuf git_author_name
= STRBUF_INIT
;
15 static struct strbuf git_author_email
= STRBUF_INIT
;
16 static struct strbuf git_committer_name
= STRBUF_INIT
;
17 static struct strbuf git_committer_email
= STRBUF_INIT
;
18 static int default_email_is_bogus
;
19 static int default_name_is_bogus
;
21 static int ident_use_config_only
;
23 #define IDENT_NAME_GIVEN 01
24 #define IDENT_MAIL_GIVEN 02
25 #define IDENT_ALL_GIVEN (IDENT_NAME_GIVEN|IDENT_MAIL_GIVEN)
26 static int committer_ident_explicitly_given
;
27 static int author_ident_explicitly_given
;
28 static int ident_config_given
;
30 #ifdef NO_GECOS_IN_PWENT
31 #define get_gecos(ignored) "&"
33 #define get_gecos(struct_passwd) ((struct_passwd)->pw_gecos)
36 static struct passwd
*xgetpwuid_self(int *is_bogus
)
41 pw
= getpwuid(getuid());
43 static struct passwd fallback
;
44 fallback
.pw_name
= "unknown";
45 #ifndef NO_GECOS_IN_PWENT
46 fallback
.pw_gecos
= "Unknown";
55 static void copy_gecos(const struct passwd
*w
, struct strbuf
*name
)
59 /* Traditionally GECOS field had office phone numbers etc, separated
60 * with commas. Also & stands for capitalized form of the login name.
63 for (src
= get_gecos(w
); *src
&& *src
!= ','; src
++) {
66 strbuf_addch(name
, ch
);
68 /* Sorry, Mr. McDonald... */
69 strbuf_addch(name
, toupper(*w
->pw_name
));
70 strbuf_addstr(name
, w
->pw_name
+ 1);
75 static int add_mailname_host(struct strbuf
*buf
)
78 struct strbuf mailnamebuf
= STRBUF_INIT
;
80 mailname
= fopen_or_warn("/etc/mailname", "r");
84 if (strbuf_getline(&mailnamebuf
, mailname
) == EOF
) {
86 warning_errno("cannot read /etc/mailname");
87 strbuf_release(&mailnamebuf
);
92 strbuf_addbuf(buf
, &mailnamebuf
);
93 strbuf_release(&mailnamebuf
);
98 static int canonical_name(const char *host
, struct strbuf
*out
)
103 struct addrinfo hints
, *ai
;
104 memset (&hints
, '\0', sizeof (hints
));
105 hints
.ai_flags
= AI_CANONNAME
;
106 if (!getaddrinfo(host
, NULL
, &hints
, &ai
)) {
107 if (ai
&& ai
->ai_canonname
&& strchr(ai
->ai_canonname
, '.')) {
108 strbuf_addstr(out
, ai
->ai_canonname
);
114 struct hostent
*he
= gethostbyname(host
);
115 if (he
&& strchr(he
->h_name
, '.')) {
116 strbuf_addstr(out
, he
->h_name
);
124 static void add_domainname(struct strbuf
*out
, int *is_bogus
)
126 char buf
[HOST_NAME_MAX
+ 1];
128 if (xgethostname(buf
, sizeof(buf
))) {
129 warning_errno("cannot get host name");
130 strbuf_addstr(out
, "(none)");
134 if (strchr(buf
, '.'))
135 strbuf_addstr(out
, buf
);
136 else if (canonical_name(buf
, out
) < 0) {
137 strbuf_addf(out
, "%s.(none)", buf
);
142 static void copy_email(const struct passwd
*pw
, struct strbuf
*email
,
146 * Make up a fake email address
147 * (name + '@' + hostname [+ '.' + domainname])
149 strbuf_addstr(email
, pw
->pw_name
);
150 strbuf_addch(email
, '@');
152 if (!add_mailname_host(email
))
153 return; /* read from "/etc/mailname" (Debian) */
154 add_domainname(email
, is_bogus
);
157 const char *ident_default_name(void)
159 if (!(ident_config_given
& IDENT_NAME_GIVEN
) && !git_default_name
.len
) {
160 copy_gecos(xgetpwuid_self(&default_name_is_bogus
), &git_default_name
);
161 strbuf_trim(&git_default_name
);
163 return git_default_name
.buf
;
166 const char *ident_default_email(void)
168 if (!(ident_config_given
& IDENT_MAIL_GIVEN
) && !git_default_email
.len
) {
169 const char *email
= getenv("EMAIL");
171 if (email
&& email
[0]) {
172 strbuf_addstr(&git_default_email
, email
);
173 committer_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
174 author_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
175 } else if ((email
= query_user_email()) && email
[0]) {
176 strbuf_addstr(&git_default_email
, email
);
179 copy_email(xgetpwuid_self(&default_email_is_bogus
),
180 &git_default_email
, &default_email_is_bogus
);
181 strbuf_trim(&git_default_email
);
183 return git_default_email
.buf
;
186 static const char *ident_default_date(void)
188 if (!git_default_date
.len
)
189 datestamp(&git_default_date
);
190 return git_default_date
.buf
;
193 void reset_ident_date(void)
195 strbuf_reset(&git_default_date
);
198 static int crud(unsigned char c
)
212 static int has_non_crud(const char *str
)
214 for (; *str
; str
++) {
222 * Copy over a string to the destination, but avoid special
223 * characters ('\n', '<' and '>') and remove crud at the end
225 static void strbuf_addstr_without_crud(struct strbuf
*sb
, const char *src
)
230 /* Remove crud from the beginning.. */
231 while ((c
= *src
) != 0) {
237 /* Remove crud from the end.. */
247 * Copy the rest to the buffer, but avoid the special
248 * characters '\n' '<' and '>' that act as delimiters on
249 * an identification line. We can only remove crud, never add it,
250 * so 'len' is our maximum.
252 strbuf_grow(sb
, len
);
253 for (i
= 0; i
< len
; i
++) {
256 case '\n': case '<': case '>':
259 sb
->buf
[sb
->len
++] = c
;
261 sb
->buf
[sb
->len
] = '\0';
265 * Reverse of fmt_ident(); given an ident line, split the fields
266 * to allow the caller to parse it.
267 * Signal a success by returning 0, but date/tz fields of the result
268 * can still be NULL if the input line only has the name/email part
269 * (e.g. reading from a reflog entry).
271 int split_ident_line(struct ident_split
*split
, const char *line
, int len
)
277 memset(split
, 0, sizeof(*split
));
279 split
->name_begin
= line
;
280 for (cp
= line
; *cp
&& cp
< line
+ len
; cp
++)
282 split
->mail_begin
= cp
+ 1;
285 if (!split
->mail_begin
)
288 for (cp
= split
->mail_begin
- 2; line
<= cp
; cp
--)
290 split
->name_end
= cp
+ 1;
293 if (!split
->name_end
) {
294 /* no human readable name */
295 split
->name_end
= split
->name_begin
;
298 for (cp
= split
->mail_begin
; cp
< line
+ len
; cp
++)
300 split
->mail_end
= cp
;
303 if (!split
->mail_end
)
307 * Look from the end-of-line to find the trailing ">" of the mail
308 * address, even though we should already know it as split->mail_end.
309 * This can help in cases of broken idents with an extra ">" somewhere
310 * in the email address. Note that we are assuming the timestamp will
311 * never have a ">" in it.
313 * Note that we will always find some ">" before going off the front of
314 * the string, because will always hit the split->mail_end closing
317 for (cp
= line
+ len
- 1; *cp
!= '>'; cp
--)
320 for (cp
= cp
+ 1; cp
< line
+ len
&& isspace(*cp
); cp
++)
322 if (line
+ len
<= cp
)
324 split
->date_begin
= cp
;
325 span
= strspn(cp
, "0123456789");
328 split
->date_end
= split
->date_begin
+ span
;
329 for (cp
= split
->date_end
; cp
< line
+ len
&& isspace(*cp
); cp
++)
331 if (line
+ len
<= cp
|| (*cp
!= '+' && *cp
!= '-'))
333 split
->tz_begin
= cp
;
334 span
= strspn(cp
+ 1, "0123456789");
337 split
->tz_end
= split
->tz_begin
+ 1 + span
;
341 split
->date_begin
= NULL
;
342 split
->date_end
= NULL
;
343 split
->tz_begin
= NULL
;
344 split
->tz_end
= NULL
;
348 static const char *env_hint
=
350 "*** Please tell me who you are.\n"
354 " git config --global user.email \"you@example.com\"\n"
355 " git config --global user.name \"Your Name\"\n"
357 "to set your account\'s default identity.\n"
358 "Omit --global to set the identity only in this repository.\n"
361 const char *fmt_ident(const char *name
, const char *email
,
362 enum want_ident whose_ident
, const char *date_str
, int flag
)
364 static struct strbuf ident
= STRBUF_INIT
;
365 int strict
= (flag
& IDENT_STRICT
);
366 int want_date
= !(flag
& IDENT_NO_DATE
);
367 int want_name
= !(flag
& IDENT_NO_NAME
);
370 if (whose_ident
== WANT_AUTHOR_IDENT
&& git_author_email
.len
)
371 email
= git_author_email
.buf
;
372 else if (whose_ident
== WANT_COMMITTER_IDENT
&& git_committer_email
.len
)
373 email
= git_committer_email
.buf
;
376 if (strict
&& ident_use_config_only
377 && !(ident_config_given
& IDENT_MAIL_GIVEN
)) {
378 fputs(_(env_hint
), stderr
);
379 die(_("no email was given and auto-detection is disabled"));
381 email
= ident_default_email();
382 if (strict
&& default_email_is_bogus
) {
383 fputs(_(env_hint
), stderr
);
384 die(_("unable to auto-detect email address (got '%s')"), email
);
389 int using_default
= 0;
391 if (whose_ident
== WANT_AUTHOR_IDENT
&& git_author_name
.len
)
392 name
= git_author_name
.buf
;
393 else if (whose_ident
== WANT_COMMITTER_IDENT
&&
394 git_committer_name
.len
)
395 name
= git_committer_name
.buf
;
398 if (strict
&& ident_use_config_only
399 && !(ident_config_given
& IDENT_NAME_GIVEN
)) {
400 fputs(_(env_hint
), stderr
);
401 die(_("no name was given and auto-detection is disabled"));
403 name
= ident_default_name();
405 if (strict
&& default_name_is_bogus
) {
406 fputs(_(env_hint
), stderr
);
407 die(_("unable to auto-detect name (got '%s')"), name
);
414 fputs(_(env_hint
), stderr
);
415 die(_("empty ident name (for <%s>) not allowed"), email
);
417 pw
= xgetpwuid_self(NULL
);
420 if (strict
&& !has_non_crud(name
))
421 die(_("name consists only of disallowed characters: %s"), name
);
424 strbuf_reset(&ident
);
426 strbuf_addstr_without_crud(&ident
, name
);
427 strbuf_addstr(&ident
, " <");
429 strbuf_addstr_without_crud(&ident
, email
);
431 strbuf_addch(&ident
, '>');
433 strbuf_addch(&ident
, ' ');
434 if (date_str
&& date_str
[0]) {
435 if (parse_date(date_str
, &ident
) < 0)
436 die(_("invalid date format: %s"), date_str
);
439 strbuf_addstr(&ident
, ident_default_date());
445 const char *fmt_name(enum want_ident whose_ident
)
450 switch (whose_ident
) {
451 case WANT_BLANK_IDENT
:
453 case WANT_AUTHOR_IDENT
:
454 name
= getenv("GIT_AUTHOR_NAME");
455 email
= getenv("GIT_AUTHOR_EMAIL");
457 case WANT_COMMITTER_IDENT
:
458 name
= getenv("GIT_COMMITTER_NAME");
459 email
= getenv("GIT_COMMITTER_EMAIL");
462 return fmt_ident(name
, email
, whose_ident
, NULL
,
463 IDENT_STRICT
| IDENT_NO_DATE
);
466 const char *git_author_info(int flag
)
468 if (getenv("GIT_AUTHOR_NAME"))
469 author_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
470 if (getenv("GIT_AUTHOR_EMAIL"))
471 author_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
472 return fmt_ident(getenv("GIT_AUTHOR_NAME"),
473 getenv("GIT_AUTHOR_EMAIL"),
475 getenv("GIT_AUTHOR_DATE"),
479 const char *git_committer_info(int flag
)
481 if (getenv("GIT_COMMITTER_NAME"))
482 committer_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
483 if (getenv("GIT_COMMITTER_EMAIL"))
484 committer_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
485 return fmt_ident(getenv("GIT_COMMITTER_NAME"),
486 getenv("GIT_COMMITTER_EMAIL"),
487 WANT_COMMITTER_IDENT
,
488 getenv("GIT_COMMITTER_DATE"),
492 static int ident_is_sufficient(int user_ident_explicitly_given
)
495 return (user_ident_explicitly_given
& IDENT_MAIL_GIVEN
);
497 return (user_ident_explicitly_given
== IDENT_ALL_GIVEN
);
501 int committer_ident_sufficiently_given(void)
503 return ident_is_sufficient(committer_ident_explicitly_given
);
506 int author_ident_sufficiently_given(void)
508 return ident_is_sufficient(author_ident_explicitly_given
);
511 static int set_ident(const char *var
, const char *value
)
513 if (!strcmp(var
, "author.name")) {
515 return config_error_nonbool(var
);
516 strbuf_reset(&git_author_name
);
517 strbuf_addstr(&git_author_name
, value
);
518 author_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
519 ident_config_given
|= IDENT_NAME_GIVEN
;
523 if (!strcmp(var
, "author.email")) {
525 return config_error_nonbool(var
);
526 strbuf_reset(&git_author_email
);
527 strbuf_addstr(&git_author_email
, value
);
528 author_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
529 ident_config_given
|= IDENT_MAIL_GIVEN
;
533 if (!strcmp(var
, "committer.name")) {
535 return config_error_nonbool(var
);
536 strbuf_reset(&git_committer_name
);
537 strbuf_addstr(&git_committer_name
, value
);
538 committer_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
539 ident_config_given
|= IDENT_NAME_GIVEN
;
543 if (!strcmp(var
, "committer.email")) {
545 return config_error_nonbool(var
);
546 strbuf_reset(&git_committer_email
);
547 strbuf_addstr(&git_committer_email
, value
);
548 committer_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
549 ident_config_given
|= IDENT_MAIL_GIVEN
;
553 if (!strcmp(var
, "user.name")) {
555 return config_error_nonbool(var
);
556 strbuf_reset(&git_default_name
);
557 strbuf_addstr(&git_default_name
, value
);
558 committer_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
559 author_ident_explicitly_given
|= IDENT_NAME_GIVEN
;
560 ident_config_given
|= IDENT_NAME_GIVEN
;
564 if (!strcmp(var
, "user.email")) {
566 return config_error_nonbool(var
);
567 strbuf_reset(&git_default_email
);
568 strbuf_addstr(&git_default_email
, value
);
569 committer_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
570 author_ident_explicitly_given
|= IDENT_MAIL_GIVEN
;
571 ident_config_given
|= IDENT_MAIL_GIVEN
;
578 int git_ident_config(const char *var
, const char *value
, void *data
)
580 if (!strcmp(var
, "user.useconfigonly")) {
581 ident_use_config_only
= git_config_bool(var
, value
);
585 return set_ident(var
, value
);
588 static int buf_cmp(const char *a_begin
, const char *a_end
,
589 const char *b_begin
, const char *b_end
)
591 int a_len
= a_end
- a_begin
;
592 int b_len
= b_end
- b_begin
;
593 int min
= a_len
< b_len
? a_len
: b_len
;
596 cmp
= memcmp(a_begin
, b_begin
, min
);
600 return a_len
- b_len
;
603 int ident_cmp(const struct ident_split
*a
,
604 const struct ident_split
*b
)
608 cmp
= buf_cmp(a
->mail_begin
, a
->mail_end
,
609 b
->mail_begin
, b
->mail_end
);
613 return buf_cmp(a
->name_begin
, a
->name_end
,
614 b
->name_begin
, b
->name_end
);