dbus/dbus-uuidgen.c

   1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
   2 /* dbus-uuidgen.c  The guts of the dbus-uuidgen binary live in libdbus, in this file.
   3  *
   4  * Copyright (C) 2006  Red Hat, Inc.
   5  *
   6  * Licensed under the Academic Free License version 2.1
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  21  *
  22  */
  23 #include <config.h>
  24 #include "dbus-uuidgen.h"
  25 #include "dbus-internals.h"
  26 #include "dbus-string.h"
  27 #include "dbus-protocol.h"
  28
  29 #ifdef DBUS_WIN
  30 #error "dbus-uuidgen should not be needed on Windows"
  31 #endif
  32
  33 /**
  34  * @defgroup DBusInternalsUuidgen dbus-uuidgen implementation
  35  * @ingroup DBusInternals
  36  * @brief Functions for dbus-uuidgen binary
  37  *
  38  * These are not considered part of the ABI, and if you call them
  39  * you will get screwed by future changes.
  40  *
  41  * @{
  42  */
  43
  44 static dbus_bool_t
  45 return_uuid (DBusGUID   *uuid,
  46              char      **uuid_p,
  47              DBusError  *error)
  48 {
  49   if (uuid_p)
  50     {
  51       DBusString encoded;
  52
  53       if (!_dbus_string_init (&encoded))
  54         {
  55           _DBUS_SET_OOM (error);
  56           return FALSE;
  57         }
  58
  59       if (!_dbus_uuid_encode (uuid, &encoded) ||
  60           !_dbus_string_steal_data (&encoded, uuid_p))
  61         {
  62           _DBUS_SET_OOM (error);
  63           _dbus_string_free (&encoded);
  64           return FALSE;
  65         }
  66       _dbus_string_free (&encoded);
  67     }
  68   return TRUE;
  69 }
  70
  71 /**
  72  * For use by the dbus-uuidgen binary ONLY, do not call this.
  73  * We can and will change this function without modifying
  74  * the libdbus soname.
  75  *
  76  * @param filename the file or #NULL for the machine ID file
  77  * @param uuid_p out param to return the uuid
  78  * @param create_if_not_found whether to create it if not already there
  79  * @param error error return
  80  * @returns #FALSE if error is set
  81  */
  82 dbus_bool_t
  83 dbus_internal_do_not_use_get_uuid (const char *filename,
  84                                    char      **uuid_p,
  85                                    dbus_bool_t create_if_not_found,
  86                                    DBusError  *error)
  87 {
  88   DBusGUID uuid;
  89
  90   if (filename)
  91     {
  92       DBusString filename_str;
  93       _dbus_string_init_const (&filename_str, filename);
  94       if (!_dbus_read_uuid_file (&filename_str, &uuid, create_if_not_found, error))
  95         goto error;
  96     }
  97   else
  98     {
  99       if (!_dbus_read_local_machine_uuid (&uuid, create_if_not_found, error))
 100         goto error;
 101     }
 102
 103   if (!return_uuid(&uuid, uuid_p, error))
 104     goto error;
 105
 106   return TRUE;
 107
 108  error:
 109   _DBUS_ASSERT_ERROR_IS_SET (error);
 110   return FALSE;
 111 }
 112
 113 /**
 114  * For use by the dbus-uuidgen binary ONLY, do not call this.
 115  * We can and will change this function without modifying
 116  * the libdbus soname.
 117  *
 118  * @param uuid_p out param to return the uuid
 119  * @returns #FALSE if no memory
 120  */
 121 dbus_bool_t
 122 dbus_internal_do_not_use_create_uuid (char      **uuid_p)
 123 {
 124   DBusGUID uuid;
 125
 126   _dbus_generate_uuid (&uuid);
 127   return return_uuid (&uuid, uuid_p, NULL);
 128 }
 129
 130 /** @} */