Hex Artifact Content
Not logged in

Artifact 94609061795ec922b92e861ca07c0f1124c3231a:

File src/name.c part of check-in [e8c4f69c50] - Change all mentions of "UUID" in the documentation and help screens into either "artifact ID" or "baseline ID" or "ticket ID" as appropriate. "UUID" has a widely recognized meaning that is different from its meaning in fossil. "UUID" is still used in code comments and in variable names. by drh on 2008-10-24 13:27:53.

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 69 64 0a 2a 2a 0a 2a 2a  name-to-id.**.**
10d0: 20 43 6f 6e 76 65 72 74 20 61 20 6e 61 6d 65 20   Convert a name 
10e0: 74 6f 20 61 20 66 75 6c 6c 20 61 72 74 69 66 61  to a full artifa
10f0: 63 74 20 49 44 2e 0a 2a 2f 0a 76 6f 69 64 20 74  ct ID..*/.void t
1100: 65 73 74 5f 6e 61 6d 65 5f 74 6f 5f 69 64 28 76  est_name_to_id(v
1110: 6f 69 64 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  oid){.  int i;. 
1120: 20 42 6c 6f 62 20 6e 61 6d 65 3b 0a 20 20 64 62   Blob name;.  db
1130: 5f 6d 75 73 74 5f 62 65 5f 77 69 74 68 69 6e 5f  _must_be_within_
1140: 74 72 65 65 28 29 3b 0a 20 20 66 6f 72 28 69 3d  tree();.  for(i=
1150: 32 3b 20 69 3c 67 2e 61 72 67 63 3b 20 69 2b 2b  2; i<g.argc; i++
1160: 29 7b 0a 20 20 20 20 62 6c 6f 62 5f 69 6e 69 74  ){.    blob_init
1170: 28 26 6e 61 6d 65 2c 20 67 2e 61 72 67 76 5b 69  (&name, g.argv[i
1180: 5d 2c 20 2d 31 29 3b 0a 20 20 20 20 70 72 69 6e  ], -1);.    prin
1190: 74 66 28 22 25 73 20 2d 3e 20 22 2c 20 67 2e 61  tf("%s -> ", g.a
11a0: 72 67 76 5b 69 5d 29 3b 0a 20 20 20 20 69 66 28  rgv[i]);.    if(
11b0: 20 6e 61 6d 65 5f 74 6f 5f 75 75 69 64 28 26 6e   name_to_uuid(&n
11c0: 61 6d 65 2c 20 31 29 20 29 7b 0a 20 20 20 20 20  ame, 1) ){.     
11d0: 20 70 72 69 6e 74 66 28 22 45 52 52 4f 52 3a 20   printf("ERROR: 
11e0: 25 73 5c 6e 22 2c 20 67 2e 7a 45 72 72 4d 73 67  %s\n", g.zErrMsg
11f0: 29 3b 0a 20 20 20 20 20 20 66 6f 73 73 69 6c 5f  );.      fossil_
1200: 65 72 72 6f 72 5f 72 65 73 65 74 28 29 3b 0a 20  error_reset();. 
1210: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
1220: 70 72 69 6e 74 66 28 22 25 73 5c 6e 22 2c 20 62  printf("%s\n", b
1230: 6c 6f 62 5f 62 75 66 66 65 72 28 26 6e 61 6d 65  lob_buffer(&name
1240: 29 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 62 6c  ));.    }.    bl
1250: 6f 62 5f 72 65 73 65 74 28 26 6e 61 6d 65 29 3b  ob_reset(&name);
1260: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f  .  }.}../*.** Co
1270: 6e 76 65 72 74 20 61 20 6e 61 6d 65 20 74 6f 20  nvert a name to 
1280: 61 20 72 69 64 2e 20 20 49 66 20 74 68 65 20 6e  a rid.  If the n
1290: 61 6d 65 20 69 73 20 61 20 73 6d 61 6c 6c 20 69  ame is a small i
12a0: 6e 74 65 67 65 72 20 76 61 6c 75 65 20 74 68 65  nteger value the
12b0: 6e 0a 2a 2a 20 6a 75 73 74 20 75 73 65 20 61 74  n.** just use at
12c0: 6f 69 28 29 20 74 6f 20 64 6f 20 74 68 65 20 63  oi() to do the c
12d0: 6f 6e 76 65 72 73 69 6f 6e 2e 20 20 49 66 20 74  onversion.  If t
12e0: 68 65 20 6e 61 6d 65 20 63 6f 6e 74 61 69 6e 73  he name contains
12f0: 20 61 6c 70 68 61 62 65 74 69 63 0a 2a 2a 20 63   alphabetic.** c
1300: 68 61 72 61 63 74 65 72 73 20 6f 72 20 69 73 20  haracters or is 
1310: 6e 6f 74 20 61 6e 20 65 78 69 73 74 69 6e 67 20  not an existing 
1320: 72 69 64 2c 20 74 68 65 6e 20 75 73 65 20 6e 61  rid, then use na
1330: 6d 65 5f 74 6f 5f 75 75 69 64 20 74 68 65 6e 0a  me_to_uuid then.
1340: 2a 2a 20 63 6f 6e 76 65 72 74 20 74 68 65 20 75  ** convert the u
1350: 75 69 64 20 74 6f 20 61 20 72 69 64 2e 0a 2a 2a  uid to a rid..**
1360: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
1370: 20 69 73 20 75 73 65 64 20 69 6e 20 74 65 73 74   is used in test
1380: 20 72 6f 75 74 69 6e 65 73 20 74 6f 20 72 65 73   routines to res
1390: 6f 6c 76 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e  olve command-lin
13a0: 65 20 69 6e 70 75 74 73 0a 2a 2a 20 69 6e 74 6f  e inputs.** into
13b0: 20 61 20 72 69 64 2e 0a 2a 2f 0a 69 6e 74 20 6e   a rid..*/.int n
13c0: 61 6d 65 5f 74 6f 5f 72 69 64 28 63 6f 6e 73 74  ame_to_rid(const
13d0: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 7b 0a 20   char *zName){. 
13e0: 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 72 69   int i;.  int ri
13f0: 64 3b 0a 20 20 42 6c 6f 62 20 6e 61 6d 65 3b 0a  d;.  Blob name;.
1400: 20 20 66 6f 72 28 69 3d 30 3b 20 7a 4e 61 6d 65    for(i=0; zName
1410: 5b 69 5d 20 26 26 20 69 73 64 69 67 69 74 28 7a  [i] && isdigit(z
1420: 4e 61 6d 65 5b 69 5d 29 3b 20 69 2b 2b 29 7b 7d  Name[i]); i++){}
1430: 0a 20 20 69 66 28 20 7a 4e 61 6d 65 5b 69 5d 3d  .  if( zName[i]=
1440: 3d 30 20 29 7b 0a 20 20 20 20 72 69 64 20 3d 20  =0 ){.    rid = 
1450: 61 74 6f 69 28 7a 4e 61 6d 65 29 3b 0a 20 20 20  atoi(zName);.   
1460: 20 69 66 28 20 64 62 5f 65 78 69 73 74 73 28 22   if( db_exists("
1470: 53 45 4c 45 43 54 20 31 20 46 52 4f 4d 20 62 6c  SELECT 1 FROM bl
1480: 6f 62 20 57 48 45 52 45 20 72 69 64 3d 25 64 22  ob WHERE rid=%d"
1490: 2c 20 72 69 64 29 20 29 7b 0a 20 20 20 20 20 20  , rid) ){.      
14a0: 72 65 74 75 72 6e 20 72 69 64 3b 0a 20 20 20 20  return rid;.    
14b0: 7d 0a 20 20 7d 0a 20 20 62 6c 6f 62 5f 69 6e 69  }.  }.  blob_ini
14c0: 74 28 26 6e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20  t(&name, zName, 
14d0: 2d 31 29 3b 0a 20 20 69 66 28 20 6e 61 6d 65 5f  -1);.  if( name_
14e0: 74 6f 5f 75 75 69 64 28 26 6e 61 6d 65 2c 20 31  to_uuid(&name, 1
14f0: 29 20 29 7b 0a 20 20 20 20 66 6f 73 73 69 6c 5f  ) ){.    fossil_
1500: 66 61 74 61 6c 28 22 25 73 22 2c 20 67 2e 7a 45  fatal("%s", g.zE
1510: 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 72 69  rrMsg);.  }.  ri
1520: 64 20 3d 20 64 62 5f 69 6e 74 28 30 2c 20 22 53  d = db_int(0, "S
1530: 45 4c 45 43 54 20 72 69 64 20 46 52 4f 4d 20 62  ELECT rid FROM b
1540: 6c 6f 62 20 57 48 45 52 45 20 75 75 69 64 3d 25  lob WHERE uuid=%
1550: 42 22 2c 20 26 6e 61 6d 65 29 3b 0a 20 20 62 6c  B", &name);.  bl
1560: 6f 62 5f 72 65 73 65 74 28 26 6e 61 6d 65 29 3b  ob_reset(&name);
1570: 0a 20 20 72 65 74 75 72 6e 20 72 69 64 3b 0a 7d  .  return rid;.}
1580: 0a                                               .