]> Creatis software - gdcm.git/blob - src/gdcmUtil.cxx
BUG: On Win32 64bits integer are a pain to use
[gdcm.git] / src / gdcmUtil.cxx
1 /*=========================================================================
2                                                                                 
3   Program:   gdcm
4   Module:    $RCSfile: gdcmUtil.cxx,v $
5   Language:  C++
6   Date:      $Date: 2005/01/21 20:49:37 $
7   Version:   $Revision: 1.117 $
8                                                                                 
9   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
10   l'Image). All rights reserved. See Doc/License.txt or
11   http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
12                                                                                 
13      This software is distributed WITHOUT ANY WARRANTY; without even
14      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15      PURPOSE.  See the above copyright notices for more information.
16                                                                                 
17 =========================================================================*/
18
19 #include "gdcmUtil.h"
20 #include "gdcmDebug.h"
21 #include <iostream>
22
23 // For GetCurrentDate, GetCurrentTime
24 #include <time.h>
25 #include <sys/types.h>
26 #include <sys/stat.h>
27
28 #ifdef _MSC_VER
29 #include <sys/timeb.h>
30 #else
31 #include <sys/time.h>
32 #endif
33
34 #include <stdarg.h>  //only included in implementation file
35 #include <stdio.h>   //only included in implementation file
36
37 #if defined(_MSC_VER) || defined(__MINGW32__)
38    #include <winsock.h>  // for gethostname & gethostbyname
39    #undef GetCurrentTime
40 #else
41 #ifndef __BORLANDC__
42    #include <unistd.h>  // for gethostname
43    #include <netdb.h>   // for gethostbyname
44 #endif
45 #endif
46
47 // For GetMACAddress
48 #ifdef _WIN32
49    #include <snmp.h>
50    #include <conio.h>
51 #else
52    #include <unistd.h>
53    #include <stdlib.h>
54    #include <string.h>
55    #include <sys/types.h>
56 #endif
57
58 #ifdef CMAKE_HAVE_SYS_IOCTL_H
59    #include <sys/ioctl.h>  // For SIOCGIFCONF on Linux
60 #endif
61 #ifdef CMAKE_HAVE_SYS_SOCKET_H
62    #include <sys/socket.h>
63 #endif
64 #ifdef CMAKE_HAVE_SYS_SOCKIO_H
65    #include <sys/sockio.h>  // For SIOCGIFCONF on SunOS
66 #endif
67 #ifdef CMAKE_HAVE_NET_IF_H
68    #include <net/if.h>
69 #endif
70 #ifdef CMAKE_HAVE_NETINET_IN_H
71    #include <netinet/in.h>   //For IPPROTO_IP
72 #endif
73 #ifdef CMAKE_HAVE_NET_IF_DL_H
74    #include <net/if_dl.h>
75 #endif
76 #if defined(CMAKE_HAVE_NET_IF_ARP_H) && defined(__sun)
77    // This is absolutely necessary on SunOS
78    #include <net/if_arp.h>
79 #endif
80
81 // For GetCurrentThreadID()
82 #ifdef __linux__
83 #include <sys/types.h>
84 #include <linux/unistd.h>
85 #endif
86 #ifdef __sun
87 #include <thread.h>
88 #endif
89
90 namespace gdcm 
91 {
92 /**
93  * \brief Provide a better 'c++' approach for sprintf
94  * For example c code is:
95  * sprintf(trash, "%04x|%04x", group , elem);
96  *
97  * c++ code is 
98  * std::ostringstream buf;
99  * buf << std::right << std::setw(4) << std::setfill('0') << std::hex
100  *     << group << "|" << std::right << std::setw(4) << std::setfill('0') 
101  *     << std::hex <<  elem;
102  * buf.str();
103  *
104  * gdcm style code is
105  * Format("%04x|%04x", group , elem);
106  */
107
108 std::string Util::Format(const char *format, ...)
109 {
110    char buffer[2048];
111    va_list args;
112    va_start(args, format);
113    vsprintf(buffer, format, args);  //might be a security flaw
114    va_end(args); // Each invocation of va_start should be matched 
115                  // by a corresponding invocation of va_end
116                  // args is then 'undefined'
117    return buffer;
118 }
119
120
121 /**
122  * \brief Because not available in C++ (?)
123  */
124 void Util::Tokenize (const std::string &str,
125                      std::vector<std::string> &tokens,
126                      const std::string& delimiters)
127 {
128    std::string::size_type lastPos = str.find_first_not_of(delimiters,0);
129    std::string::size_type pos     = str.find_first_of    (delimiters,lastPos);
130    while (std::string::npos != pos || std::string::npos != lastPos)
131    {
132       tokens.push_back(str.substr(lastPos, pos - lastPos));
133       lastPos = str.find_first_not_of(delimiters, pos);
134       pos     = str.find_first_of    (delimiters, lastPos);
135    }
136 }
137
138 /**
139  * \brief Because not available in C++ (?)
140  *        Counts the number of occurences of a substring within a string
141  */
142  
143 int Util::CountSubstring (const std::string &str,
144                           const std::string &subStr)
145 {
146    int count = 0;   // counts how many times it appears
147    std::string::size_type x = 0;       // The index position in the string
148
149    do
150    {
151       x = str.find(subStr,x);       // Find the substring
152       if (x != std::string::npos)   // If present
153       {
154          count++;                  // increase the count
155          x += subStr.length();     // Skip this word
156       }
157    }
158    while (x != std::string::npos);  // Carry on until not present
159
160    return count;
161 }
162
163 /**
164  * \brief  Weed out a string from the non-printable characters (in order
165  *         to avoid corrupting the terminal of invocation when printing)
166  * @param s string to remove non printable characters from
167  */
168 std::string Util::CreateCleanString(std::string const &s)
169 {
170    std::string str = s;
171
172    for(unsigned int i=0; i<str.size(); i++)
173    {
174       if(!isprint((unsigned char)str[i]))
175       {
176          str[i] = '.';
177       }
178    }
179
180    if(str.size() > 0)
181    {
182       if(!isprint((unsigned char)s[str.size()-1]))
183       {
184          if(s[str.size()-1] == 0)
185          {
186             str[str.size()-1] = ' ';
187          }
188       }
189    }
190
191    return str;
192 }
193
194 /**
195  * \brief   Add a SEPARATOR to the end of the name is necessary
196  * @param   pathname file/directory name to normalize 
197  */
198 std::string Util::NormalizePath(std::string const &pathname)
199 {
200    const char SEPARATOR_X      = '/';
201    const char SEPARATOR_WIN    = '\\';
202    const std::string SEPARATOR = "/";
203    std::string name = pathname;
204    int size = name.size();
205
206    if( name[size-1] != SEPARATOR_X && name[size-1] != SEPARATOR_WIN )
207    {
208       name += SEPARATOR;
209    }
210    return name;
211 }
212
213 /**
214  * \brief   Get the (directory) path from a full path file name
215  * @param   fullName file/directory name to extract Path from
216  */
217 std::string Util::GetPath(std::string const &fullName)
218 {
219    std::string res = fullName;
220    int pos1 = res.rfind("/");
221    int pos2 = res.rfind("\\");
222    if( pos1 > pos2)
223    {
224       res.resize(pos1);
225    }
226    else
227    {
228       res.resize(pos2);
229    }
230
231    return res;
232 }
233
234 /**
235  * \brief   Get the (last) name of a full path file name
236  * @param   fullName file/directory name to extract end name from
237  */
238 std::string Util::GetName(std::string const &fullName)
239 {   
240   std::string filename = fullName;
241
242   std::string::size_type slash_pos = filename.rfind("/");
243   std::string::size_type backslash_pos = filename.rfind("\\");
244   slash_pos = slash_pos > backslash_pos ? slash_pos : backslash_pos;
245   if(slash_pos != std::string::npos)
246     {
247     return filename.substr(slash_pos + 1);
248     }
249   else
250     {
251     return filename;
252     }
253
254
255 /**
256  * \brief   Get the current date of the system in a dicom string
257  */
258 std::string Util::GetCurrentDate()
259 {
260     char tmp[512];
261     time_t tloc;
262     time (&tloc);    
263     strftime(tmp,512,"%Y%m%d", localtime(&tloc) );
264     return tmp;
265 }
266
267 /**
268  * \brief   Get the current time of the system in a dicom string
269  */
270 std::string Util::GetCurrentTime()
271 {
272     char tmp[512];
273     time_t tloc;
274     time (&tloc);
275     strftime(tmp,512,"%H%M%S", localtime(&tloc) );
276     return tmp;  
277 }
278
279 /**
280  * \brief  Get both the date and time at the same time to avoid problem 
281  * around midnight where two call could be before and after midnight
282  */
283 std::string Util::GetCurrentDateTime()
284 {
285    char tmp[40];
286    long milliseconds;
287    time_t *timep;
288   
289    // We need implementation specific functions to obtain millisecond precision
290 #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__MINGW32__)
291    struct timeb tb;
292    ::ftime(&tb);
293    timep = &tb.time;
294    milliseconds = tb.millitm;
295 #else
296    struct timeval tv;
297    gettimeofday (&tv, NULL);
298    timep = &tv.tv_sec;
299    // Compute milliseconds from microseconds.
300    milliseconds = tv.tv_usec / 1000;
301 #endif
302    // Obtain the time of day, and convert it to a tm struct.
303    struct tm *ptm = localtime (timep);
304    // Format the date and time, down to a single second.
305    strftime (tmp, sizeof (tmp), "%Y%m%d%H%M%S", ptm);
306
307    // Add milliseconds
308    std::string r = tmp;
309    r += Format("%03ld", milliseconds);
310
311    return r;
312 }
313
314 /**
315  * \brief Create a /DICOM/ string:
316  * It should a of even length (no odd length ever)
317  * It can contain as many (if you are reading this from your
318  * editor the following character is is backslash followed by zero
319  * that needed to be escaped with an extra backslash for doxygen) \\0
320  * as you want.
321  */
322 std::string Util::DicomString(const char *s, size_t l)
323 {
324    std::string r(s, s+l);
325    gdcmAssertMacro( !(r.size() % 2) ); // == basically 'l' is even
326    return r;
327 }
328
329 /**
330  * \brief Create a /DICOM/ string:
331  * It should a of even lenght (no odd length ever)
332  * It can contain as many (if you are reading this from your
333  * editor the following character is is backslash followed by zero
334  * that needed to be escaped with an extra backslash for doxygen) \\0
335  * as you want.
336  * This function is similar to DicomString(const char*), 
337  * except it doesn't take a lenght. 
338  * It only pad with a null character if length is odd
339  */
340 std::string Util::DicomString(const char *s)
341 {
342    size_t l = strlen(s);
343    if( l%2 )
344    {
345       l++;
346    }
347    std::string r(s, s+l);
348    gdcmAssertMacro( !(r.size() % 2) );
349    return r;
350 }
351
352 /**
353  * \brief Safely compare two Dicom String:
354  *        - Both string should be of even lenght
355  *        - We allow padding of even lenght string by either a null 
356  *          character of a space
357  */
358 bool Util::DicomStringEqual(const std::string &s1, const char *s2)
359 {
360   // s2 is the string from the DICOM reference: 'MONOCHROME1'
361   std::string s1_even = s1; //Never change input parameter
362   std::string s2_even = DicomString( s2 );
363   if( s1_even[s1_even.size()-1] == ' ')
364   {
365     s1_even[s1_even.size()-1] = '\0'; //replace space character by null
366   }
367   return s1_even == s2_even;
368 }
369
370 /**
371  * \brief   tells us if the processor we are working with is BigEndian or not
372  */
373 bool Util::IsCurrentProcessorBigEndian()
374 {
375 #ifdef GDCM_WORDS_BIGENDIAN
376    return true;
377 #else
378    return false;
379 #endif
380 }
381
382
383
384 #ifdef _WIN32
385 typedef BOOL(WINAPI * pSnmpExtensionInit) (
386         IN DWORD dwTimeZeroReference,
387         OUT HANDLE * hPollForTrapEvent,
388         OUT AsnObjectIdentifier * supportedView);
389
390 typedef BOOL(WINAPI * pSnmpExtensionTrap) (
391         OUT AsnObjectIdentifier * enterprise,
392         OUT AsnInteger * genericTrap,
393         OUT AsnInteger * specificTrap,
394         OUT AsnTimeticks * timeStamp,
395         OUT RFC1157VarBindList * variableBindings);
396
397 typedef BOOL(WINAPI * pSnmpExtensionQuery) (
398         IN BYTE requestType,
399         IN OUT RFC1157VarBindList * variableBindings,
400         OUT AsnInteger * errorStatus,
401         OUT AsnInteger * errorIndex);
402
403 typedef BOOL(WINAPI * pSnmpExtensionInitEx) (
404         OUT AsnObjectIdentifier * supportedView);
405 #endif //_WIN32
406
407
408 int GetMacAddrSys ( unsigned char *addr )
409 {
410 #ifdef _WIN32
411    WSADATA WinsockData;
412    if (WSAStartup(MAKEWORD(2, 0), &WinsockData) != 0) 
413    {
414       std::cerr << "This program requires Winsock 2.x!" << std::endl;
415       return -1;
416    }
417
418    HANDLE PollForTrapEvent;
419    AsnObjectIdentifier SupportedView;
420    UINT OID_ifEntryType[] = { 1, 3, 6, 1, 2, 1, 2, 2, 1, 3 };
421    UINT OID_ifEntryNum[] = { 1, 3, 6, 1, 2, 1, 2, 1 };
422    UINT OID_ipMACEntAddr[] = { 1, 3, 6, 1, 2, 1, 2, 2, 1, 6 };
423    AsnObjectIdentifier MIB_ifMACEntAddr = {
424        sizeof(OID_ipMACEntAddr) / sizeof(UINT), OID_ipMACEntAddr };
425    AsnObjectIdentifier MIB_ifEntryType = {
426        sizeof(OID_ifEntryType) / sizeof(UINT), OID_ifEntryType };
427    AsnObjectIdentifier MIB_ifEntryNum = {
428        sizeof(OID_ifEntryNum) / sizeof(UINT), OID_ifEntryNum };
429    RFC1157VarBindList varBindList;
430    RFC1157VarBind varBind[2];
431    AsnInteger errorStatus;
432    AsnInteger errorIndex;
433    AsnObjectIdentifier MIB_NULL = { 0, 0 };
434    int ret;
435    int dtmp;
436    int j = 0;
437
438    // Load the SNMP dll and get the addresses of the functions necessary
439    HINSTANCE m_hInst = LoadLibrary("inetmib1.dll");
440    if (m_hInst < (HINSTANCE) HINSTANCE_ERROR)
441    {
442       return -1;
443    }
444    pSnmpExtensionInit m_Init =
445        (pSnmpExtensionInit) GetProcAddress(m_hInst, "SnmpExtensionInit");
446    pSnmpExtensionQuery m_Query =
447        (pSnmpExtensionQuery) GetProcAddress(m_hInst, "SnmpExtensionQuery");
448    m_Init(GetTickCount(), &PollForTrapEvent, &SupportedView);
449
450    /* Initialize the variable list to be retrieved by m_Query */
451    varBindList.list = varBind;
452    varBind[0].name = MIB_NULL;
453    varBind[1].name = MIB_NULL;
454
455    // Copy in the OID to find the number of entries in the
456    // Inteface table
457    varBindList.len = 1;        // Only retrieving one item
458    SNMP_oidcpy(&varBind[0].name, &MIB_ifEntryNum);
459    m_Query(ASN_RFC1157_GETNEXTREQUEST, &varBindList, &errorStatus,
460                  &errorIndex);
461 //   printf("# of adapters in this system : %i\n",
462 //          varBind[0].value.asnValue.number);
463    varBindList.len = 2;
464
465    // Copy in the OID of ifType, the type of interface
466    SNMP_oidcpy(&varBind[0].name, &MIB_ifEntryType);
467
468    // Copy in the OID of ifPhysAddress, the address
469    SNMP_oidcpy(&varBind[1].name, &MIB_ifMACEntAddr);
470
471    do
472    {
473       // Submit the query.  Responses will be loaded into varBindList.
474       // We can expect this call to succeed a # of times corresponding
475       // to the # of adapters reported to be in the system
476       ret = m_Query(ASN_RFC1157_GETNEXTREQUEST, &varBindList, &errorStatus,
477                     &errorIndex); 
478       if (!ret)
479       {
480          ret = 1;
481       }
482       else
483       {
484          // Confirm that the proper type has been returned
485          ret = SNMP_oidncmp(&varBind[0].name, &MIB_ifEntryType,
486                             MIB_ifEntryType.idLength);
487       }
488       if (!ret)
489       {
490          j++;
491          dtmp = varBind[0].value.asnValue.number;
492
493          // Type 6 describes ethernet interfaces
494          if (dtmp == 6)
495          {
496             // Confirm that we have an address here
497             ret = SNMP_oidncmp(&varBind[1].name, &MIB_ifMACEntAddr,
498                                MIB_ifMACEntAddr.idLength);
499             if ( !ret && varBind[1].value.asnValue.address.stream != NULL )
500             {
501                if ( (varBind[1].value.asnValue.address.stream[0] == 0x44)
502                  && (varBind[1].value.asnValue.address.stream[1] == 0x45)
503                  && (varBind[1].value.asnValue.address.stream[2] == 0x53)
504                  && (varBind[1].value.asnValue.address.stream[3] == 0x54)
505                  && (varBind[1].value.asnValue.address.stream[4] == 0x00) )
506                {
507                    // Ignore all dial-up networking adapters
508                    std::cerr << "Interface #" << j << " is a DUN adapter\n";
509                    continue;
510                }
511                if ( (varBind[1].value.asnValue.address.stream[0] == 0x00)
512                  && (varBind[1].value.asnValue.address.stream[1] == 0x00)
513                  && (varBind[1].value.asnValue.address.stream[2] == 0x00)
514                  && (varBind[1].value.asnValue.address.stream[3] == 0x00)
515                  && (varBind[1].value.asnValue.address.stream[4] == 0x00)
516                  && (varBind[1].value.asnValue.address.stream[5] == 0x00) )
517                {
518                   // Ignore NULL addresses returned by other network
519                   // interfaces
520                   std::cerr << "Interface #" << j << " is a NULL address\n";
521                   continue;
522                }
523                memcpy( addr, varBind[1].value.asnValue.address.stream, 6);
524             }
525          }
526       }
527    } while (!ret);
528
529    // Free the bindings
530    SNMP_FreeVarBind(&varBind[0]);
531    SNMP_FreeVarBind(&varBind[1]);
532    return 0;
533 #endif //Win32 version
534
535
536 // implementation for POSIX system
537 #ifdef __sun
538    //The POSIX version is broken anyway on Solaris, plus would require full
539    //root power
540    struct  arpreq          parpreq;
541    struct  sockaddr_in     *psa;
542    struct  hostent         *phost;
543    char                    hostname[MAXHOSTNAMELEN];
544    char                    **paddrs;
545    int                     sock, status=0;
546
547    if(gethostname(hostname,  MAXHOSTNAMELEN) != 0)
548    {
549       perror("gethostname");
550       return -1;
551    }
552    phost = gethostbyname(hostname);
553    paddrs = phost->h_addr_list;
554
555    sock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP);
556    if(sock == -1)
557    {
558       perror("sock");
559       return -1;
560    }
561    memset(&parpreq, 0, sizeof(struct arpreq));
562    psa = (struct sockaddr_in *) &parpreq.arp_pa;
563
564    memset(psa, 0, sizeof(struct sockaddr_in));
565    psa->sin_family = AF_INET;
566    memcpy(&psa->sin_addr, *paddrs, sizeof(struct in_addr));
567
568    status = ioctl(sock, SIOCGARP, &parpreq);
569    if(status == -1)
570    {
571       perror("SIOCGARP");
572       return -1;
573    }
574    memcpy(addr, parpreq.arp_ha.sa_data, 6);
575
576    return 0;
577 #else
578 #ifdef CMAKE_HAVE_NET_IF_H
579    int       sd;
580    struct ifreq    ifr, *ifrp;
581    struct ifconf    ifc;
582    char buf[1024];
583    int      n, i;
584    unsigned char    *a;
585 #if defined(AF_LINK) && (!defined(SIOCGIFHWADDR) && !defined(SIOCGENADDR))
586    struct sockaddr_dl *sdlp;
587 #endif
588
589 //
590 // BSD 4.4 defines the size of an ifreq to be
591 // max(sizeof(ifreq), sizeof(ifreq.ifr_name)+ifreq.ifr_addr.sa_len
592 // However, under earlier systems, sa_len isn't present, so the size is 
593 // just sizeof(struct ifreq)
594 // We should investiage the use of SIZEOF_ADDR_IFREQ
595 //
596 #ifdef HAVE_SA_LEN
597 #ifndef max
598 #define max(a,b) ((a) > (b) ? (a) : (b))
599 #endif
600 #define ifreq_size(i) max(sizeof(struct ifreq),\
601      sizeof((i).ifr_name)+(i).ifr_addr.sa_len)
602 #else
603 #define ifreq_size(i) sizeof(struct ifreq)
604 #endif // HAVE_SA_LEN
605
606    if( (sd = socket(AF_INET, SOCK_DGRAM, IPPROTO_IP)) < 0 )
607    {
608       return -1;
609    }
610    memset(buf, 0, sizeof(buf));
611    ifc.ifc_len = sizeof(buf);
612    ifc.ifc_buf = buf;
613    if (ioctl (sd, SIOCGIFCONF, (char *)&ifc) < 0)
614    {
615       close(sd);
616       return -1;
617    }
618    n = ifc.ifc_len;
619    for (i = 0; i < n; i+= ifreq_size(*ifrp) )
620    {
621       ifrp = (struct ifreq *)((char *) ifc.ifc_buf+i);
622       strncpy(ifr.ifr_name, ifrp->ifr_name, IFNAMSIZ);
623 #ifdef SIOCGIFHWADDR
624       if (ioctl(sd, SIOCGIFHWADDR, &ifr) < 0)
625          continue;
626       a = (unsigned char *) &ifr.ifr_hwaddr.sa_data;
627 #else
628 #ifdef SIOCGENADDR
629       // In theory this call should also work on Sun Solaris, but apparently
630       // SIOCGENADDR is not implemented properly thus the call 
631       // ioctl(sd, SIOCGENADDR, &ifr) always returns errno=2 
632       // (No such file or directory)
633       // Furthermore the DLAPI seems to require full root access
634       if (ioctl(sd, SIOCGENADDR, &ifr) < 0)
635          continue;
636       a = (unsigned char *) ifr.ifr_enaddr;
637 #else
638 #ifdef AF_LINK
639       sdlp = (struct sockaddr_dl *) &ifrp->ifr_addr;
640       if ((sdlp->sdl_family != AF_LINK) || (sdlp->sdl_alen != 6))
641          continue;
642       a = (unsigned char *) &sdlp->sdl_data[sdlp->sdl_nlen];
643 #else
644       perror("No way to access hardware");
645       close(sd);
646       return -1;
647 #endif // AF_LINK
648 #endif // SIOCGENADDR
649 #endif // SIOCGIFHWADDR
650       if (!a[0] && !a[1] && !a[2] && !a[3] && !a[4] && !a[5]) continue;
651
652       if (addr) 
653       {
654          memcpy(addr, a, 6);
655          close(sd);
656          return 0;
657       }
658    }
659    close(sd);
660 #endif
661    // Not implemented platforms
662    perror("There was a configuration problem on your plateform");
663    memset(addr,0,6);
664    return -1;
665 #endif //__sun
666 }
667
668 /**
669  * \brief Encode the mac address on a fixed lenght string of 15 characters.
670  * we save space this way.
671  */
672 std::string Util::GetMACAddress()
673 {
674    // This code is the result of a long internet search to find something
675    // as compact as possible (not OS independant). We only have to separate
676    // 3 OS: Win32, SunOS and 'real' POSIX
677    // http://groups-beta.google.com/group/comp.unix.solaris/msg/ad36929d783d63be
678    // http://bdn.borland.com/article/0,1410,26040,00.html
679    union dual { uint64_t n; unsigned char addr[6];  };
680  
681    // zero-initialize the whole thing first:
682    dual d = { 0 };
683    int stat = GetMacAddrSys(d.addr);
684    if (stat == 0)
685    {
686       // fill with zero to fit on 15 bytes.
687 #if defined(_MSC_VER) || defined(__BORLANDC__)
688       return Format("%015I64u", d.n);
689 #else
690       return Format("%015llu", d.n);
691 #endif
692    }
693    else
694    {
695       gdcmVerboseMacro("Problem in finding the MAC Address");
696       return "";
697    }
698 }
699
700 /**
701  * \brief   Return the IP adress of the machine writting the DICOM image
702  */
703 std::string Util::GetIPAddress()
704 {
705    // This is a rip from 
706    // http://www.codeguru.com/Cpp/I-N/internet/network/article.php/c3445/
707 #ifndef HOST_NAME_MAX
708    // SUSv2 guarantees that `Host names are limited to 255 bytes'.
709    // POSIX 1003.1-2001 guarantees that `Host names (not including the
710    // terminating NUL) are limited to HOST_NAME_MAX bytes'.
711 #  define HOST_NAME_MAX 255
712    // In this case we should maybe check the string was not truncated.
713    // But I don't known how to check that...
714 #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__MINGW32__)
715    // with WinSock DLL we need to initialize the WinSock before using gethostname
716    WORD wVersionRequested = MAKEWORD(1,0);
717    WSADATA WSAData;
718    int err = WSAStartup(wVersionRequested,&WSAData);
719    if (err != 0)
720    {
721       // Tell the user that we could not find a usable
722       // WinSock DLL.
723       WSACleanup();
724       return "127.0.0.1";
725    }
726 #endif
727   
728 #endif //HOST_NAME_MAX
729
730    std::string str;
731    char szHostName[HOST_NAME_MAX+1];
732    int r = gethostname(szHostName, HOST_NAME_MAX);
733  
734    if( r == 0 )
735    {
736       // Get host adresses
737       struct hostent *pHost = gethostbyname(szHostName);
738  
739       for( int i = 0; pHost!= NULL && pHost->h_addr_list[i]!= NULL; i++ )
740       {
741          for( int j = 0; j<pHost->h_length; j++ )
742          {
743             if( j > 0 ) str += ".";
744  
745             str += Util::Format("%u", 
746                 (unsigned int)((unsigned char*)pHost->h_addr_list[i])[j]);
747          }
748          // str now contains one local IP address 
749  
750 #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__MINGW32__)
751    WSACleanup();
752 #endif
753
754       }
755    }
756    // If an error occur r == -1
757    // Most of the time it will return 127.0.0.1...
758    return str;
759 }
760
761 /**
762  * \brief Creates a new UID. As stipulate in the DICOM ref
763  *        each time a DICOM image is create it should have 
764  *        a unique identifier (URI)
765  * @param root is the DICOM prefix assigned by IOS group
766  * @param is a string you want to append to the UID.
767  */
768 std::string Util::CreateUniqueUID(const std::string &root)
769 {
770    std::string prefix = root;
771    std::string append;
772    if( root.empty() )
773    {
774       // No root was specified use "GDCM" then
775       // echo "gdcm" | od -b
776       // 0000000 147 144 143 155 012
777       prefix = "147.144.143.155"; // special easter egg 
778    }
779    // else
780    // A root was specified use it to forge our new UID:
781    append += ".";
782    append += Util::GetMACAddress();
783    append += ".";
784    append += Util::GetCurrentDateTime();
785
786    //Also add a mini random number just in case:
787    int r = (int) (100.0*rand()/RAND_MAX);
788    append += Format("%02d", r);
789
790    // If append is too long we need to rehash it
791    if( (prefix + append).size() > 64 )
792    {
793       gdcmErrorMacro( "Size of UID is too long." );
794       // we need a hash function to truncate this number
795       // if only md5 was cross plateform
796       // MD5(append);
797    }
798
799    return prefix + append;
800 }
801
802 unsigned int Util::GetCurrentThreadID()
803 {
804 // FIXME the implementation is far from complete
805 #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__MINGW32__)
806   return (unsigned int)GetCurrentThreadId();
807 #endif
808 #ifdef __linux__
809    return 0;
810    // Doesn't work on fedora, but is in the man page...
811    //return (unsigned int)gettid();
812 #endif
813 #ifdef __sun
814    return (unsigned int)thr_self();
815 #endif
816 }
817
818 unsigned int Util::GetCurrentProcessID()
819 {
820 #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__MINGW32__)
821   // NOTE: There is also a _getpid()...
822   return (unsigned int)GetCurrentProcessId();
823 #else
824   // get process identification, POSIX
825   return (unsigned int)getpid();
826 #endif
827
828 }
829
830 /**
831  * \brief
832  * @param os ostream to write to
833  * @param val val
834  */ 
835 template <class T>
836 std::ostream &binary_write(std::ostream &os, const T &val)
837 {
838    return os.write(reinterpret_cast<const char*>(&val), sizeof val);
839 }
840
841 /**
842  * \brief binary_write binary_write
843  * @param os ostream to write to 
844  * @param val val
845  */ 
846 std::ostream &binary_write(std::ostream &os, const uint16_t &val)
847 {
848 #ifdef GDCM_WORDS_BIGENDIAN
849    uint16_t swap;
850    swap = ((( val << 8 ) & 0x0ff00 ) | (( val >> 8 ) & 0x00ff ) );
851    return os.write(reinterpret_cast<const char*>(&swap), 2);
852 #else
853    return os.write(reinterpret_cast<const char*>(&val), 2);
854 #endif //GDCM_WORDS_BIGENDIAN
855 }
856
857 /**
858  * \brief binary_write binary_write
859  * @param os ostream to write to
860  * @param val val
861  */ 
862 std::ostream &binary_write(std::ostream &os, const uint32_t &val)
863 {
864 #ifdef GDCM_WORDS_BIGENDIAN
865    uint32_t swap;
866    swap = ( ((val<<24) & 0xff000000) | ((val<<8)  & 0x00ff0000) | 
867             ((val>>8)  & 0x0000ff00) | ((val>>24) & 0x000000ff) );
868    return os.write(reinterpret_cast<const char*>(&swap), 4);
869 #else
870    return os.write(reinterpret_cast<const char*>(&val), 4);
871 #endif //GDCM_WORDS_BIGENDIAN
872 }
873
874 /**
875  * \brief  binary_write binary_write
876  * @param os ostream to write to
877  * @param val val
878  */ 
879 std::ostream &binary_write(std::ostream &os, const char *val)
880 {
881    return os.write(val, strlen(val));
882 }
883
884 /**
885  * \brief
886  * @param os ostream to write to
887  * @param val val
888  */ 
889 std::ostream &binary_write(std::ostream &os, std::string const &val)
890 {
891    return os.write(val.c_str(), val.size());
892 }
893
894 } // end namespace gdcm
895