Hex Artifact Content
Not logged in

Artifact 68dd0b644f488d7d9fadd24683b8f2e8f0052b52:

File src/name.c part of check-in [5113ab5981] - Clarify some comments in name.c by eric on 2008-09-03 18:52:48. Also file src/name.c part of check-in [8745d0d579] - Merge tagview branch into mainline by eric on 2008-09-06 13:29:29.

0000: 2f 2a 0a 2a 2a 20 43 6f 70 79 72 69 67 68 74 20  /*.** Copyright 
0010: 28 63 29 20 32 30 30 36 20 44 2e 20 52 69 63 68  (c) 2006 D. Rich
0020: 61 72 64 20 48 69 70 70 0a 2a 2a 0a 2a 2a 20 54  ard Hipp.**.** T
0030: 68 69 73 20 70 72 6f 67 72 61 6d 20 69 73 20 66  his program is f
0040: 72 65 65 20 73 6f 66 74 77 61 72 65 3b 20 79 6f  ree software; yo
0050: 75 20 63 61 6e 20 72 65 64 69 73 74 72 69 62 75  u can redistribu
0060: 74 65 20 69 74 20 61 6e 64 2f 6f 72 0a 2a 2a 20  te it and/or.** 
0070: 6d 6f 64 69 66 79 20 69 74 20 75 6e 64 65 72 20  modify it under 
0080: 74 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65  the terms of the
0090: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62   GNU General Pub
00a0: 6c 69 63 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 76  lic.** License v
00b0: 65 72 73 69 6f 6e 20 32 20 61 73 20 70 75 62 6c  ersion 2 as publ
00c0: 69 73 68 65 64 20 62 79 20 74 68 65 20 46 72 65  ished by the Fre
00d0: 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64  e Software Found
00e0: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  ation..**.** Thi
00f0: 73 20 70 72 6f 67 72 61 6d 20 69 73 20 64 69 73  s program is dis
0100: 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 65 20  tributed in the 
0110: 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 69 6c  hope that it wil
0120: 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 2a 2a 20  l be useful,.** 
0130: 62 75 74 20 57 49 54 48 4f 55 54 20 41 4e 59 20  but WITHOUT ANY 
0140: 57 41 52 52 41 4e 54 59 3b 20 77 69 74 68 6f 75  WARRANTY; withou
0150: 74 20 65 76 65 6e 20 74 68 65 20 69 6d 70 6c 69  t even the impli
0160: 65 64 20 77 61 72 72 61 6e 74 79 20 6f 66 0a 2a  ed warranty of.*
0170: 2a 20 4d 45 52 43 48 41 4e 54 41 42 49 4c 49 54  * MERCHANTABILIT
0180: 59 20 6f 72 20 46 49 54 4e 45 53 53 20 46 4f 52  Y or FITNESS FOR
0190: 20 41 20 50 41 52 54 49 43 55 4c 41 52 20 50 55   A PARTICULAR PU
01a0: 52 50 4f 53 45 2e 20 20 53 65 65 20 74 68 65 20  RPOSE.  See the 
01b0: 47 4e 55 0a 2a 2a 20 47 65 6e 65 72 61 6c 20 50  GNU.** General P
01c0: 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f  ublic License fo
01d0: 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a  r more details..
01e0: 2a 2a 20 0a 2a 2a 20 59 6f 75 20 73 68 6f 75 6c  ** .** You shoul
01f0: 64 20 68 61 76 65 20 72 65 63 65 69 76 65 64 20  d have received 
0200: 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 47 4e  a copy of the GN
0210: 55 20 47 65 6e 65 72 61 6c 20 50 75 62 6c 69 63  U General Public
0220: 0a 2a 2a 20 4c 69 63 65 6e 73 65 20 61 6c 6f 6e  .** License alon
0230: 67 20 77 69 74 68 20 74 68 69 73 20 6c 69 62 72  g with this libr
0240: 61 72 79 3b 20 69 66 20 6e 6f 74 2c 20 77 72 69  ary; if not, wri
0250: 74 65 20 74 6f 20 74 68 65 0a 2a 2a 20 46 72 65  te to the.** Fre
0260: 65 20 53 6f 66 74 77 61 72 65 20 46 6f 75 6e 64  e Software Found
0270: 61 74 69 6f 6e 2c 20 49 6e 63 2e 2c 20 35 39 20  ation, Inc., 59 
0280: 54 65 6d 70 6c 65 20 50 6c 61 63 65 20 2d 20 53  Temple Place - S
0290: 75 69 74 65 20 33 33 30 2c 0a 2a 2a 20 42 6f 73  uite 330,.** Bos
02a0: 74 6f 6e 2c 20 4d 41 20 20 30 32 31 31 31 2d 31  ton, MA  02111-1
02b0: 33 30 37 2c 20 55 53 41 2e 0a 2a 2a 0a 2a 2a 20  307, USA..**.** 
02c0: 41 75 74 68 6f 72 20 63 6f 6e 74 61 63 74 20 69  Author contact i
02d0: 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 20 20  nformation:.**  
02e0: 20 64 72 68 40 68 77 61 63 69 2e 63 6f 6d 0a 2a   drh@hwaci.com.*
02f0: 2a 20 20 20 68 74 74 70 3a 2f 2f 77 77 77 2e 68  *   http://www.h
0300: 77 61 63 69 2e 63 6f 6d 2f 64 72 68 2f 0a 2a 2a  waci.com/drh/.**
0310: 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  .***************
0320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0350: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0360: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65  .**.** This file
0370: 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75   contains code u
0380: 73 65 64 20 74 6f 20 63 6f 6e 76 65 72 74 20 75  sed to convert u
0390: 73 65 72 2d 73 75 70 70 6c 69 65 64 20 6f 62 6a  ser-supplied obj
03a0: 65 63 74 20 6e 61 6d 65 73 20 69 6e 74 6f 0a 2a  ect names into.*
03b0: 2a 20 63 61 6e 6f 6e 69 63 61 6c 20 55 55 49 44  * canonical UUID
03c0: 73 2e 0a 2a 2a 0a 2a 2a 20 41 20 75 73 65 72 2d  s..**.** A user-
03d0: 73 75 70 70 6c 69 65 64 20 6f 62 6a 65 63 74 20  supplied object 
03e0: 6e 61 6d 65 20 69 73 20 61 6e 79 20 75 6e 69 71  name is any uniq
03f0: 75 65 20 70 72 65 66 69 78 20 6f 66 20 61 20 76  ue prefix of a v
0400: 61 6c 69 64 20 55 55 49 44 20 62 75 74 0a 2a 2a  alid UUID but.**
0410: 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79   not necessarily
0420: 20 69 6e 20 63 61 6e 6f 6e 69 63 61 6c 20 66 6f   in canonical fo
0430: 72 6d 2e 20 20 0a 2a 2f 0a 23 69 6e 63 6c 75 64  rm.  .*/.#includ
0440: 65 20 22 63 6f 6e 66 69 67 2e 68 22 0a 23 69 6e  e "config.h".#in
0450: 63 6c 75 64 65 20 22 6e 61 6d 65 2e 68 22 0a 23  clude "name.h".#
0460: 69 6e 63 6c 75 64 65 20 3c 61 73 73 65 72 74 2e  include <assert.
0470: 68 3e 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  h>../*.** This r
0480: 6f 75 74 69 6e 65 20 74 61 6b 65 73 20 61 20 75  outine takes a u
0490: 73 65 72 2d 65 6e 74 65 72 65 64 20 55 55 49 44  ser-entered UUID
04a0: 20 77 68 69 63 68 20 6d 69 67 68 74 20 62 65 20   which might be 
04b0: 69 6e 20 6d 69 78 65 64 0a 2a 2a 20 63 61 73 65  in mixed.** case
04c0: 20 61 6e 64 20 6d 69 67 68 74 20 6f 6e 6c 79 20   and might only 
04d0: 62 65 20 61 20 70 72 65 66 69 78 20 6f 66 20 74  be a prefix of t
04e0: 68 65 20 66 75 6c 6c 20 55 55 49 44 20 61 6e 64  he full UUID and
04f0: 20 63 6f 6e 76 65 72 74 73 20 69 74 0a 2a 2a 20   converts it.** 
0500: 69 6e 74 6f 20 74 68 65 20 66 75 6c 6c 2d 6c 65  into the full-le
0510: 6e 67 74 68 20 55 55 49 44 20 69 6e 20 63 61 6e  ngth UUID in can
0520: 6f 6e 69 63 61 6c 20 66 6f 72 6d 2e 0a 2a 2a 0a  onical form..**.
0530: 2a 2a 20 49 66 20 74 68 65 20 69 6e 70 75 74 20  ** If the input 
0540: 69 73 20 6e 6f 74 20 61 20 55 55 49 44 20 6f 72  is not a UUID or
0550: 20 61 20 55 55 49 44 20 70 72 65 66 69 78 2c 20   a UUID prefix, 
0560: 74 68 65 6e 20 74 72 79 20 74 6f 20 72 65 73 6f  then try to reso
0570: 6c 76 65 0a 2a 2a 20 74 68 65 20 6e 61 6d 65 20  lve.** the name 
0580: 61 73 20 61 20 74 61 67 2e 0a 2a 2a 0a 2a 2a 20  as a tag..**.** 
0590: 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65  Return the numbe
05a0: 72 20 6f 66 20 65 72 72 6f 72 73 2e 0a 2a 2f 0a  r of errors..*/.
05b0: 69 6e 74 20 6e 61 6d 65 5f 74 6f 5f 75 75 69 64  int name_to_uuid
05c0: 28 42 6c 6f 62 20 2a 70 4e 61 6d 65 2c 20 69 6e  (Blob *pName, in
05d0: 74 20 69 45 72 72 50 72 69 6f 72 69 74 79 29 7b  t iErrPriority){
05e0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74  .  int rc;.  int
05f0: 20 73 7a 3b 0a 20 20 73 7a 20 3d 20 62 6c 6f 62   sz;.  sz = blob
0600: 5f 73 69 7a 65 28 70 4e 61 6d 65 29 3b 0a 20 20  _size(pName);.  
0610: 69 66 28 20 73 7a 3e 55 55 49 44 5f 53 49 5a 45  if( sz>UUID_SIZE
0620: 20 7c 7c 20 73 7a 3c 34 20 7c 7c 20 21 76 61 6c   || sz<4 || !val
0630: 69 64 61 74 65 31 36 28 62 6c 6f 62 5f 62 75 66  idate16(blob_buf
0640: 66 65 72 28 70 4e 61 6d 65 29 2c 20 73 7a 29 20  fer(pName), sz) 
0650: 29 7b 0a 20 20 20 20 42 6c 6f 62 20 75 75 69 64  ){.    Blob uuid
0660: 3b 0a 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e  ;.    static con
0670: 73 74 20 63 68 61 72 20 70 72 65 66 69 78 5b 5d  st char prefix[]
0680: 20 3d 20 22 74 61 67 3a 22 3b 0a 20 20 20 20 73   = "tag:";.    s
0690: 74 61 74 69 63 20 63 6f 6e 73 74 20 69 6e 74 20  tatic const int 
06a0: 70 72 65 66 6c 65 6e 20 3d 20 73 69 7a 65 6f 66  preflen = sizeof
06b0: 28 70 72 65 66 69 78 29 2d 31 3b 0a 20 20 20 20  (prefix)-1;.    
06c0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d  const char *zNam
06d0: 65 20 3d 20 62 6c 6f 62 5f 73 74 72 28 70 4e 61  e = blob_str(pNa
06e0: 6d 65 29 3b 0a 0a 20 20 20 20 69 66 28 20 73 74  me);..    if( st
06f0: 72 6e 63 6d 70 28 7a 4e 61 6d 65 2c 20 70 72 65  rncmp(zName, pre
0700: 66 69 78 2c 20 70 72 65 66 6c 65 6e 29 3d 3d 30  fix, preflen)==0
0710: 20 29 7b 0a 20 20 20 20 20 20 7a 4e 61 6d 65 20   ){.      zName 
0720: 2b 3d 20 70 72 65 66 6c 65 6e 3b 0a 20 20 20 20  += preflen;.    
0730: 7d 0a 0a 20 20 20 20 73 79 6d 5f 74 61 67 5f 74  }..    sym_tag_t
0740: 6f 5f 75 75 69 64 28 7a 4e 61 6d 65 2c 20 26 75  o_uuid(zName, &u
0750: 75 69 64 29 3b 0a 20 20 20 20 69 66 28 20 62 6c  uid);.    if( bl
0760: 6f 62 5f 73 69 7a 65 28 26 75 75 69 64 29 3d 3d  ob_size(&uuid)==
0770: 30 20 29 7b 0a 20 20 20 20 20 20 66 6f 73 73 69  0 ){.      fossi
0780: 6c 5f 65 72 72 6f 72 28 69 45 72 72 50 72 69 6f  l_error(iErrPrio
0790: 72 69 74 79 2c 20 22 6e 6f 74 20 61 20 76 61 6c  rity, "not a val
07a0: 69 64 20 6f 62 6a 65 63 74 20 6e 61 6d 65 3a 20  id object name: 
07b0: 25 73 22 2c 20 7a 4e 61 6d 65 29 3b 0a 20 20 20  %s", zName);.   
07c0: 20 20 20 62 6c 6f 62 5f 72 65 73 65 74 28 26 75     blob_reset(&u
07d0: 75 69 64 29 3b 0a 20 20 20 20 20 20 72 65 74 75  uid);.      retu
07e0: 72 6e 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  rn 1;.    }else{
07f0: 0a 20 20 20 20 20 20 62 6c 6f 62 5f 72 65 73 65  .      blob_rese
0800: 74 28 70 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20  t(pName);.      
0810: 2a 70 4e 61 6d 65 20 3d 20 75 75 69 64 3b 0a 20  *pName = uuid;. 
0820: 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20       return 0;. 
0830: 20 20 20 7d 0a 20 20 7d 0a 20 20 62 6c 6f 62 5f     }.  }.  blob_
0840: 6d 61 74 65 72 69 61 6c 69 7a 65 28 70 4e 61 6d  materialize(pNam
0850: 65 29 3b 0a 20 20 63 61 6e 6f 6e 69 63 61 6c 31  e);.  canonical1
0860: 36 28 62 6c 6f 62 5f 62 75 66 66 65 72 28 70 4e  6(blob_buffer(pN
0870: 61 6d 65 29 2c 20 73 7a 29 3b 0a 20 20 69 66 28  ame), sz);.  if(
0880: 20 73 7a 3d 3d 55 55 49 44 5f 53 49 5a 45 20 29   sz==UUID_SIZE )
0890: 7b 0a 20 20 20 20 72 63 20 3d 20 64 62 5f 69 6e  {.    rc = db_in
08a0: 74 28 31 2c 20 22 53 45 4c 45 43 54 20 30 20 46  t(1, "SELECT 0 F
08b0: 52 4f 4d 20 62 6c 6f 62 20 57 48 45 52 45 20 75  ROM blob WHERE u
08c0: 75 69 64 3d 25 42 22 2c 20 70 4e 61 6d 65 29 3b  uid=%B", pName);
08d0: 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20  .    if( rc ){. 
08e0: 20 20 20 20 20 66 6f 73 73 69 6c 5f 65 72 72 6f       fossil_erro
08f0: 72 28 69 45 72 72 50 72 69 6f 72 69 74 79 2c 20  r(iErrPriority, 
0900: 22 75 6e 6b 6e 6f 77 6e 20 6f 62 6a 65 63 74 3a  "unknown object:
0910: 20 25 62 22 2c 20 70 4e 61 6d 65 29 3b 0a 20 20   %b", pName);.  
0920: 20 20 20 20 62 6c 6f 62 5f 72 65 73 65 74 28 70      blob_reset(p
0930: 4e 61 6d 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Name);.    }.  }
0940: 65 6c 73 65 20 69 66 28 20 73 7a 3c 55 55 49 44  else if( sz<UUID
0950: 5f 53 49 5a 45 20 26 26 20 73 7a 3e 3d 34 20 29  _SIZE && sz>=4 )
0960: 7b 0a 20 20 20 20 63 68 61 72 20 7a 4f 72 69 67  {.    char zOrig
0970: 5b 55 55 49 44 5f 53 49 5a 45 2b 31 5d 3b 0a 20  [UUID_SIZE+1];. 
0980: 20 20 20 6d 65 6d 63 70 79 28 7a 4f 72 69 67 2c     memcpy(zOrig,
0990: 20 62 6c 6f 62 5f 62 75 66 66 65 72 28 70 4e 61   blob_buffer(pNa
09a0: 6d 65 29 2c 20 73 7a 29 3b 0a 20 20 20 20 7a 4f  me), sz);.    zO
09b0: 72 69 67 5b 73 7a 5d 20 3d 20 30 3b 0a 20 20 20  rig[sz] = 0;.   
09c0: 20 62 6c 6f 62 5f 72 65 73 65 74 28 70 4e 61 6d   blob_reset(pNam
09d0: 65 29 3b 0a 20 20 20 20 64 62 5f 62 6c 6f 62 28  e);.    db_blob(
09e0: 70 4e 61 6d 65 2c 20 22 53 45 4c 45 43 54 20 75  pName, "SELECT u
09f0: 75 69 64 20 46 52 4f 4d 20 62 6c 6f 62 20 57 48  uid FROM blob WH
0a00: 45 52 45 20 75 75 69 64 3e 3d 27 25 73 27 22 2c  ERE uuid>='%s'",
0a10: 20 7a 4f 72 69 67 29 3b 0a 20 20 20 20 69 66 28   zOrig);.    if(
0a20: 20 62 6c 6f 62 5f 73 69 7a 65 28 70 4e 61 6d 65   blob_size(pName
0a30: 29 21 3d 55 55 49 44 5f 53 49 5a 45 20 29 7b 0a  )!=UUID_SIZE ){.
0a40: 20 20 20 20 20 20 66 6f 73 73 69 6c 5f 65 72 72        fossil_err
0a50: 6f 72 28 69 45 72 72 50 72 69 6f 72 69 74 79 2c  or(iErrPriority,
0a60: 20 22 6e 6f 20 6d 61 74 63 68 3a 20 25 73 22 2c   "no match: %s",
0a70: 20 7a 4f 72 69 67 29 3b 0a 20 20 20 20 20 20 72   zOrig);.      r
0a80: 63 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65  c = 1;.    }else
0a90: 7b 0a 20 20 20 20 20 20 7a 4f 72 69 67 5b 73 7a  {.      zOrig[sz
0aa0: 2d 31 5d 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28  -1]++;.      if(
0ab0: 20 64 62 5f 65 78 69 73 74 73 28 22 53 45 4c 45   db_exists("SELE
0ac0: 43 54 20 31 20 46 52 4f 4d 20 62 6c 6f 62 20 57  CT 1 FROM blob W
0ad0: 48 45 52 45 20 75 75 69 64 3e 25 42 20 41 4e 44  HERE uuid>%B AND
0ae0: 20 75 75 69 64 3c 27 25 73 27 22 2c 0a 20 20 20   uuid<'%s'",.   
0af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b00: 20 70 4e 61 6d 65 2c 20 7a 4f 72 69 67 29 20 29   pName, zOrig) )
0b10: 7b 0a 20 20 20 20 20 20 20 20 20 7a 4f 72 69 67  {.         zOrig
0b20: 5b 73 7a 2d 31 5d 2d 2d 3b 0a 20 20 20 20 20 20  [sz-1]--;.      
0b30: 20 20 20 66 6f 73 73 69 6c 5f 65 72 72 6f 72 28     fossil_error(
0b40: 69 45 72 72 50 72 69 6f 72 69 74 79 2c 20 22 6e  iErrPriority, "n
0b50: 6f 6e 2d 75 6e 69 71 75 65 20 6e 61 6d 65 20 70  on-unique name p
0b60: 72 65 66 69 78 3a 20 25 73 22 2c 20 7a 4f 72 69  refix: %s", zOri
0b70: 67 29 3b 0a 20 20 20 20 20 20 20 20 20 72 63 20  g);.         rc 
0b80: 3d 20 31 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  = 1;.      }else
0b90: 7b 0a 20 20 20 20 20 20 20 20 20 72 63 20 3d 20  {.         rc = 
0ba0: 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  0;.      }.    }
0bb0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63  .  }else{.    rc
0bc0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75   = 0;.  }.  retu
0bd0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
0be0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 74 61 6b  This routine tak
0bf0: 65 73 20 61 20 6e 61 6d 65 20 77 68 69 63 68 20  es a name which 
0c00: 6d 69 67 68 74 20 62 65 20 61 20 74 61 67 20 61  might be a tag a
0c10: 6e 64 20 61 74 74 65 6d 70 74 73 20 74 6f 0a 2a  nd attempts to.*
0c20: 2a 20 70 72 6f 64 75 63 65 20 61 20 55 55 49 44  * produce a UUID
0c30: 2e 20 54 68 65 20 55 55 49 44 20 28 69 66 20 61  . The UUID (if a
0c40: 6e 79 29 20 69 73 20 72 65 74 75 72 6e 65 64 20  ny) is returned 
0c50: 69 6e 20 74 68 65 20 62 6c 6f 62 20 70 6f 69 6e  in the blob poin
0c60: 74 65 64 0a 2a 2a 20 74 6f 20 62 79 20 74 68 65  ted.** to by the
0c70: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
0c80: 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61  ..**.** Return a
0c90: 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 20 20 20  s follows:.**   
0ca0: 20 20 20 30 20 20 20 4e 61 6d 65 20 69 73 20 6e     0   Name is n
0cb0: 6f 74 20 61 20 74 61 67 0a 2a 2a 20 20 20 20 20  ot a tag.**     
0cc0: 20 31 20 20 20 41 20 73 69 6e 67 6c 65 20 55 55   1   A single UU
0cd0: 49 44 20 77 61 73 20 66 6f 75 6e 64 0a 2a 2a 20  ID was found.** 
0ce0: 20 20 20 20 20 32 20 20 20 4d 6f 72 65 20 74 68       2   More th
0cf0: 61 6e 20 6f 6e 65 20 55 55 49 44 20 77 61 73 20  an one UUID was 
0d00: 66 6f 75 6e 64 2c 20 73 6f 20 74 68 69 73 20 69  found, so this i
0d10: 73 20 70 72 65 73 75 6d 61 62 6c 79 20 61 0a 2a  s presumably a.*
0d20: 2a 20 20 20 20 20 20 20 20 20 20 70 72 6f 70 61  *          propa
0d30: 67 61 74 69 6e 67 20 74 61 67 2e 20 54 68 65 20  gating tag. The 
0d40: 72 65 74 75 72 6e 20 55 55 49 44 20 69 73 20 74  return UUID is t
0d50: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 2c 0a  he most recent,.
0d60: 2a 2a 20 20 20 20 20 20 20 20 20 20 77 68 69 63  **          whic
0d70: 68 20 69 73 20 6d 6f 73 74 20 6c 69 6b 65 6c 79  h is most likely
0d80: 20 74 6f 20 62 65 20 74 68 65 20 6f 6e 65 20 77   to be the one w
0d90: 61 6e 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 74 61  anted..*/.int ta
0da0: 67 5f 74 6f 5f 75 75 69 64 28 63 6f 6e 73 74 20  g_to_uuid(const 
0db0: 63 68 61 72 20 2a 70 4e 61 6d 65 2c 20 42 6c 6f  char *pName, Blo
0dc0: 62 20 2a 70 55 75 69 64 2c 63 6f 6e 73 74 20 63  b *pUuid,const c
0dd0: 68 61 72 20 2a 70 50 72 65 66 69 78 29 7b 0a 20  har *pPrefix){. 
0de0: 20 53 74 6d 74 20 71 3b 0a 20 20 69 6e 74 20 63   Stmt q;.  int c
0df0: 6f 75 6e 74 20 3d 20 30 3b 0a 20 20 64 62 5f 70  ount = 0;.  db_p
0e00: 72 65 70 61 72 65 28 26 71 2c 0a 20 20 20 20 22  repare(&q,.    "
0e10: 53 45 4c 45 43 54 20 28 53 45 4c 45 43 54 20 75  SELECT (SELECT u
0e20: 75 69 64 20 46 52 4f 4d 20 62 6c 6f 62 20 57 48  uid FROM blob WH
0e30: 45 52 45 20 72 69 64 3d 6f 62 6a 69 64 29 22 0a  ERE rid=objid)".
0e40: 20 20 20 20 22 20 20 46 52 4f 4d 20 74 61 67 78      "  FROM tagx
0e50: 72 65 66 20 4a 4f 49 4e 20 65 76 65 6e 74 20 4f  ref JOIN event O
0e60: 4e 20 72 69 64 3d 6f 62 6a 69 64 22 0a 20 20 20  N rid=objid".   
0e70: 20 22 20 57 48 45 52 45 20 74 61 67 69 64 3d 28   " WHERE tagid=(
0e80: 53 45 4c 45 43 54 20 74 61 67 69 64 20 46 52 4f  SELECT tagid FRO
0e90: 4d 20 74 61 67 20 57 48 45 52 45 20 74 61 67 6e  M tag WHERE tagn
0ea0: 61 6d 65 3d 25 51 7c 7c 25 51 29 22 0a 20 20 20  ame=%Q||%Q)".   
0eb0: 20 22 20 20 20 41 4e 44 20 74 61 67 74 79 70 65   "   AND tagtype
0ec0: 3e 30 22 0a 20 20 20 20 22 20 20 20 41 4e 44 20  >0".    "   AND 
0ed0: 76 61 6c 75 65 20 49 53 20 4e 55 4c 4c 22 0a 20  value IS NULL". 
0ee0: 20 20 20 22 20 4f 52 44 45 52 20 42 59 20 65 76     " ORDER BY ev
0ef0: 65 6e 74 2e 6d 74 69 6d 65 20 44 45 53 43 22 2c  ent.mtime DESC",
0f00: 0a 20 20 20 20 70 50 72 65 66 69 78 2c 0a 20 20  .    pPrefix,.  
0f10: 20 20 70 4e 61 6d 65 0a 20 20 29 3b 0a 20 20 62    pName.  );.  b
0f20: 6c 6f 62 5f 7a 65 72 6f 28 70 55 75 69 64 29 3b  lob_zero(pUuid);
0f30: 0a 20 20 77 68 69 6c 65 28 20 64 62 5f 73 74 65  .  while( db_ste
0f40: 70 28 26 71 29 3d 3d 53 51 4c 49 54 45 5f 52 4f  p(&q)==SQLITE_RO
0f50: 57 20 29 7b 0a 20 20 20 20 63 6f 75 6e 74 2b 2b  W ){.    count++
0f60: 3b 0a 20 20 20 20 69 66 28 63 6f 75 6e 74 3e 31  ;.    if(count>1
0f70: 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  ){.      break;.
0f80: 20 20 20 20 7d 0a 20 20 20 20 64 62 5f 63 6f 6c      }.    db_col
0f90: 75 6d 6e 5f 62 6c 6f 62 28 26 71 2c 20 30 2c 20  umn_blob(&q, 0, 
0fa0: 70 55 75 69 64 29 3b 0a 20 20 7d 0a 20 20 64 62  pUuid);.  }.  db
0fb0: 5f 66 69 6e 61 6c 69 7a 65 28 26 71 29 3b 0a 20  _finalize(&q);. 
0fc0: 20 72 65 74 75 72 6e 20 63 6f 75 6e 74 3b 0a 7d   return count;.}
0fd0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ../*.** This rou
0fe0: 74 69 6e 65 20 74 61 6b 65 73 20 61 20 6e 61 6d  tine takes a nam
0ff0: 65 20 77 68 69 63 68 20 6d 69 67 68 74 20 62 65  e which might be
1000: 20 61 20 73 79 6d 62 6f 6c 69 63 20 74 61 67 20   a symbolic tag 
1010: 61 6e 64 0a 2a 2a 20 61 74 74 65 6d 70 74 73 20  and.** attempts 
1020: 74 6f 20 70 72 6f 64 75 63 65 20 61 20 55 55 49  to produce a UUI
1030: 44 2e 20 53 65 65 20 74 61 67 5f 74 6f 5f 75 75  D. See tag_to_uu
1040: 69 64 2e 0a 2a 2f 0a 69 6e 74 20 73 79 6d 5f 74  id..*/.int sym_t
1050: 61 67 5f 74 6f 5f 75 75 69 64 28 63 6f 6e 73 74  ag_to_uuid(const
1060: 20 63 68 61 72 20 2a 70 4e 61 6d 65 2c 20 42 6c   char *pName, Bl
1070: 6f 62 20 2a 70 55 75 69 64 29 7b 0a 20 20 20 20  ob *pUuid){.    
1080: 72 65 74 75 72 6e 20 74 61 67 5f 74 6f 5f 75 75  return tag_to_uu
1090: 69 64 28 70 4e 61 6d 65 2c 70 55 75 69 64 2c 22  id(pName,pUuid,"
10a0: 73 79 6d 2d 22 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  sym-");.}../*.**
10b0: 20 43 4f 4d 4d 41 4e 44 3a 20 20 74 65 73 74 2d   COMMAND:  test-
10c0: 6e 61 6d 65 2d 74 6f 2d 75 75 69 64 0a 2a 2a 0a  name-to-uuid.**.
10d0: 2a 2a 20 43 6f 6e 76 65 72 74 20 61 20 6e 61 6d  ** Convert a nam
10e0: 65 20 74 6f 20 61 20 66 75 6c 6c 20 55 55 49 44  e to a full UUID
10f0: 2e 0a 2a 2f 0a 76 6f 69 64 20 74 65 73 74 5f 6e  ..*/.void test_n
1100: 61 6d 65 5f 74 6f 5f 75 75 69 64 28 76 6f 69 64  ame_to_uuid(void
1110: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 42 6c  ){.  int i;.  Bl
1120: 6f 62 20 6e 61 6d 65 3b 0a 20 20 64 62 5f 6d 75  ob name;.  db_mu
1130: 73 74 5f 62 65 5f 77 69 74 68 69 6e 5f 74 72 65  st_be_within_tre
1140: 65 28 29 3b 0a 20 20 66 6f 72 28 69 3d 32 3b 20  e();.  for(i=2; 
1150: 69 3c 67 2e 61 72 67 63 3b 20 69 2b 2b 29 7b 0a  i<g.argc; i++){.
1160: 20 20 20 20 62 6c 6f 62 5f 69 6e 69 74 28 26 6e      blob_init(&n
1170: 61 6d 65 2c 20 67 2e 61 72 67 76 5b 69 5d 2c 20  ame, g.argv[i], 
1180: 2d 31 29 3b 0a 20 20 20 20 70 72 69 6e 74 66 28  -1);.    printf(
1190: 22 25 73 20 2d 3e 20 22 2c 20 67 2e 61 72 67 76  "%s -> ", g.argv
11a0: 5b 69 5d 29 3b 0a 20 20 20 20 69 66 28 20 6e 61  [i]);.    if( na
11b0: 6d 65 5f 74 6f 5f 75 75 69 64 28 26 6e 61 6d 65  me_to_uuid(&name
11c0: 2c 20 31 29 20 29 7b 0a 20 20 20 20 20 20 70 72  , 1) ){.      pr
11d0: 69 6e 74 66 28 22 45 52 52 4f 52 3a 20 25 73 5c  intf("ERROR: %s\
11e0: 6e 22 2c 20 67 2e 7a 45 72 72 4d 73 67 29 3b 0a  n", g.zErrMsg);.
11f0: 20 20 20 20 20 20 66 6f 73 73 69 6c 5f 65 72 72        fossil_err
1200: 6f 72 5f 72 65 73 65 74 28 29 3b 0a 20 20 20 20  or_reset();.    
1210: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 72 69  }else{.      pri
1220: 6e 74 66 28 22 25 73 5c 6e 22 2c 20 62 6c 6f 62  ntf("%s\n", blob
1230: 5f 62 75 66 66 65 72 28 26 6e 61 6d 65 29 29 3b  _buffer(&name));
1240: 0a 20 20 20 20 7d 0a 20 20 20 20 62 6c 6f 62 5f  .    }.    blob_
1250: 72 65 73 65 74 28 26 6e 61 6d 65 29 3b 0a 20 20  reset(&name);.  
1260: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65  }.}../*.** Conve
1270: 72 74 20 61 20 6e 61 6d 65 20 74 6f 20 61 20 72  rt a name to a r
1280: 69 64 2e 20 20 49 66 20 74 68 65 20 6e 61 6d 65  id.  If the name
1290: 20 69 73 20 61 20 73 6d 61 6c 6c 20 69 6e 74 65   is a small inte
12a0: 67 65 72 20 76 61 6c 75 65 20 74 68 65 6e 0a 2a  ger value then.*
12b0: 2a 20 6a 75 73 74 20 75 73 65 20 61 74 6f 69 28  * just use atoi(
12c0: 29 20 74 6f 20 64 6f 20 74 68 65 20 63 6f 6e 76  ) to do the conv
12d0: 65 72 73 69 6f 6e 2e 20 20 49 66 20 74 68 65 20  ersion.  If the 
12e0: 6e 61 6d 65 20 63 6f 6e 74 61 69 6e 73 20 61 6c  name contains al
12f0: 70 68 61 62 65 74 69 63 0a 2a 2a 20 63 68 61 72  phabetic.** char
1300: 61 63 74 65 72 73 20 6f 72 20 69 73 20 6e 6f 74  acters or is not
1310: 20 61 6e 20 65 78 69 73 74 69 6e 67 20 72 69 64   an existing rid
1320: 2c 20 74 68 65 6e 20 75 73 65 20 6e 61 6d 65 5f  , then use name_
1330: 74 6f 5f 75 75 69 64 20 74 68 65 6e 0a 2a 2a 20  to_uuid then.** 
1340: 63 6f 6e 76 65 72 74 20 74 68 65 20 75 75 69 64  convert the uuid
1350: 20 74 6f 20 61 20 72 69 64 2e 0a 2a 2a 0a 2a 2a   to a rid..**.**
1360: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
1370: 20 75 73 65 64 20 69 6e 20 74 65 73 74 20 72 6f   used in test ro
1380: 75 74 69 6e 65 73 20 74 6f 20 72 65 73 6f 6c 76  utines to resolv
1390: 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 69  e command-line i
13a0: 6e 70 75 74 73 0a 2a 2a 20 69 6e 74 6f 20 61 20  nputs.** into a 
13b0: 72 69 64 2e 0a 2a 2f 0a 69 6e 74 20 6e 61 6d 65  rid..*/.int name
13c0: 5f 74 6f 5f 72 69 64 28 63 6f 6e 73 74 20 63 68  _to_rid(const ch
13d0: 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a 20 20 69 6e  ar *zName){.  in
13e0: 74 20 69 3b 0a 20 20 69 6e 74 20 72 69 64 3b 0a  t i;.  int rid;.
13f0: 20 20 42 6c 6f 62 20 6e 61 6d 65 3b 0a 20 20 66    Blob name;.  f
1400: 6f 72 28 69 3d 30 3b 20 7a 4e 61 6d 65 5b 69 5d  or(i=0; zName[i]
1410: 20 26 26 20 69 73 64 69 67 69 74 28 7a 4e 61 6d   && isdigit(zNam
1420: 65 5b 69 5d 29 3b 20 69 2b 2b 29 7b 7d 0a 20 20  e[i]); i++){}.  
1430: 69 66 28 20 7a 4e 61 6d 65 5b 69 5d 3d 3d 30 20  if( zName[i]==0 
1440: 29 7b 0a 20 20 20 20 72 69 64 20 3d 20 61 74 6f  ){.    rid = ato
1450: 69 28 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 69 66  i(zName);.    if
1460: 28 20 64 62 5f 65 78 69 73 74 73 28 22 53 45 4c  ( db_exists("SEL
1470: 45 43 54 20 31 20 46 52 4f 4d 20 62 6c 6f 62 20  ECT 1 FROM blob 
1480: 57 48 45 52 45 20 72 69 64 3d 25 64 22 2c 20 72  WHERE rid=%d", r
1490: 69 64 29 20 29 7b 0a 20 20 20 20 20 20 72 65 74  id) ){.      ret
14a0: 75 72 6e 20 72 69 64 3b 0a 20 20 20 20 7d 0a 20  urn rid;.    }. 
14b0: 20 7d 0a 20 20 62 6c 6f 62 5f 69 6e 69 74 28 26   }.  blob_init(&
14c0: 6e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31 29  name, zName, -1)
14d0: 3b 0a 20 20 69 66 28 20 6e 61 6d 65 5f 74 6f 5f  ;.  if( name_to_
14e0: 75 75 69 64 28 26 6e 61 6d 65 2c 20 31 29 20 29  uuid(&name, 1) )
14f0: 7b 0a 20 20 20 20 66 6f 73 73 69 6c 5f 66 61 74  {.    fossil_fat
1500: 61 6c 28 22 25 73 22 2c 20 67 2e 7a 45 72 72 4d  al("%s", g.zErrM
1510: 73 67 29 3b 0a 20 20 7d 0a 20 20 72 69 64 20 3d  sg);.  }.  rid =
1520: 20 64 62 5f 69 6e 74 28 30 2c 20 22 53 45 4c 45   db_int(0, "SELE
1530: 43 54 20 72 69 64 20 46 52 4f 4d 20 62 6c 6f 62  CT rid FROM blob
1540: 20 57 48 45 52 45 20 75 75 69 64 3d 25 42 22 2c   WHERE uuid=%B",
1550: 20 26 6e 61 6d 65 29 3b 0a 20 20 62 6c 6f 62 5f   &name);.  blob_
1560: 72 65 73 65 74 28 26 6e 61 6d 65 29 3b 0a 20 20  reset(&name);.  
1570: 72 65 74 75 72 6e 20 72 69 64 3b 0a 7d 0a        return rid;.}.