pEpObjCAdapter/PEPObjCAdapter.m
author Dirk Zimmermann <dirk@pep-project.org>
Wed, 13 Jun 2018 09:53:43 +0200
changeset 625 6da48501887b
parent 601 10ac2d9704ac
child 635 ec6cc54d911d
permissions -rw-r--r--
IOSAD-94 global passive mode
dirk@187
     1
//
edouard@191
     2
//  pEpObjCAdapter.m
edouard@191
     3
//  pEpObjCAdapter
dirk@187
     4
//
dirk@187
     5
//  Created by Volker Birk on 28.04.15.
dirk@187
     6
//  Copyright (c) 2015 p≡p. All rights reserved.
dirk@187
     7
//
dirk@187
     8
dirk@187
     9
@import Foundation;
dirk@187
    10
dirk@187
    11
#import "PEPObjCAdapter.h"
dirk@187
    12
#import "PEPObjCAdapter+Internal.h"
dirk@367
    13
#import "PEPMessageUtil.h"
dirk@484
    14
#import "NSError+PEP.h"
dirk@484
    15
dirk@484
    16
#import "keymanagement.h"
dirk@484
    17
#import "mime.h"
dirk@484
    18
#import "message.h"
dirk@187
    19
dirk@187
    20
///////////////////////////////////////////////////////////////////////////////
dirk@187
    21
//  Keyserver and Identity lookup - C part
dirk@187
    22
dirk@187
    23
int examine_identity(pEp_identity *ident, void *management)
dirk@187
    24
{
dirk@187
    25
    //PEPQueue *q = (__bridge PEPQueue *)management;
dirk@187
    26
    PEPQueue *q = [PEPObjCAdapter getLookupQueue];
dirk@187
    27
    
dirk@187
    28
    NSDictionary *identity = PEP_identityDictFromStruct(ident);
dirk@187
    29
    
dirk@187
    30
    [q enqueue:identity];
dirk@187
    31
    return 0;
dirk@187
    32
}
dirk@187
    33
dirk@187
    34
static pEp_identity *retrieve_next_identity(void *management)
dirk@187
    35
{
dirk@187
    36
    //PEPQueue *q = (__bridge PEPQueue *)management;
dirk@187
    37
    PEPQueue *q = [PEPObjCAdapter getLookupQueue];
dirk@187
    38
    
dirk@187
    39
    // Dequeue is a blocking operation
dirk@187
    40
    // that returns nil when queue is killed
dirk@187
    41
    NSDictionary *ident = [q dequeue];
dirk@187
    42
    
dirk@187
    43
    if (ident)
dirk@187
    44
        return PEP_identityDictToStruct(ident);
dirk@187
    45
    else
dirk@187
    46
        return NULL;
dirk@187
    47
}
dirk@187
    48
dirk@187
    49
///////////////////////////////////////////////////////////////////////////////
dirk@331
    50
// Sync - C part
dirk@331
    51
dirk@331
    52
// Called by sync thread only
dirk@331
    53
PEP_STATUS notify_handshake(void *unused_object, pEp_identity *me, pEp_identity *partner, sync_handshake_signal signal)
dirk@331
    54
{
dirk@331
    55
    id <PEPSyncDelegate> syncDelegate = [PEPObjCAdapter getSyncDelegate];
dirk@331
    56
    if ( syncDelegate )
dirk@331
    57
        return [syncDelegate
dirk@331
    58
                notifyHandshakeWithSignal:signal
dirk@331
    59
                me:PEP_identityDictFromStruct(me)
dirk@331
    60
                partner:PEP_identityDictFromStruct(partner)];
dirk@331
    61
    else
dirk@331
    62
        return PEP_SYNC_NO_NOTIFY_CALLBACK;
dirk@331
    63
}
dirk@331
    64
dirk@331
    65
// Called by sync thread only
dirk@331
    66
PEP_STATUS message_to_send(void *unused_object, message *msg)
dirk@331
    67
{
dirk@331
    68
    id <PEPSyncDelegate> syncDelegate = [PEPObjCAdapter getSyncDelegate];
dirk@331
    69
    if ( syncDelegate )
dirk@331
    70
        return [syncDelegate sendMessage:PEP_messageDictFromStruct(msg)];
dirk@331
    71
    else
dirk@331
    72
        return PEP_SEND_FUNCTION_NOT_REGISTERED;
dirk@331
    73
}
dirk@331
    74
dirk@331
    75
// called indirectly by decrypt message - any thread/session
dirk@331
    76
int inject_sync_msg(void *msg, void *unused_management)
dirk@331
    77
{
dirk@331
    78
    PEPQueue *q = [PEPObjCAdapter getSyncQueue];
dirk@331
    79
    [q enqueue:[NSValue valueWithPointer:msg]];
dirk@331
    80
    
dirk@331
    81
    return 0;
dirk@331
    82
}
dirk@331
    83
dirk@331
    84
// Called by sync thread only
dirk@331
    85
void *retrieve_next_sync_msg(void *unused_mamagement, time_t *timeout)
dirk@331
    86
{
dirk@331
    87
    bool needs_fastpoll = (*timeout != 0);
dirk@331
    88
    
dirk@331
    89
    id <PEPSyncDelegate> syncDelegate = [PEPObjCAdapter getSyncDelegate];
dirk@331
    90
    if ( syncDelegate && needs_fastpoll )
dirk@331
    91
        [syncDelegate fastPolling:true];
dirk@331
    92
    
dirk@331
    93
    PEPQueue *q = [PEPObjCAdapter getSyncQueue];
dirk@331
    94
    
dirk@331
    95
    void* result = (void*)[[q timedDequeue:timeout] pointerValue];
dirk@331
    96
    
dirk@331
    97
    if ( syncDelegate && needs_fastpoll )
dirk@331
    98
        [syncDelegate fastPolling:false];
dirk@331
    99
    
dirk@331
   100
    return result;
dirk@331
   101
    
dirk@331
   102
}
dirk@331
   103
dirk@187
   104
const char* _Nullable SystemDB = NULL;
dirk@187
   105
NSURL *s_homeURL;
dirk@504
   106
static NSLock *s_writeLock;
dirk@625
   107
dirk@601
   108
static BOOL s_unEncryptedSubjectEnabled = NO;
dirk@625
   109
static BOOL s_passiveModeEnabled = NO;
dirk@187
   110
dirk@187
   111
@implementation PEPObjCAdapter
dirk@187
   112
andreas@416
   113
#pragma mark - SUBJECT PROTECTION
andreas@416
   114
dirk@601
   115
+ (BOOL)unEncryptedSubjectEnabled;
andreas@416
   116
{
dirk@601
   117
    return s_unEncryptedSubjectEnabled;
andreas@416
   118
}
andreas@416
   119
dirk@601
   120
+ (void)setUnEncryptedSubjectEnabled:(BOOL)enabled;
andreas@416
   121
{
dirk@601
   122
    s_unEncryptedSubjectEnabled = enabled;
andreas@416
   123
}
andreas@416
   124
dirk@625
   125
#pragma mark - Passive Mode
dirk@625
   126
dirk@625
   127
+ (BOOL)passiveModeEnabled
dirk@625
   128
{
dirk@625
   129
    return s_passiveModeEnabled;
dirk@625
   130
}
dirk@625
   131
dirk@625
   132
+ (void)setPassiveModeEnabled:(BOOL)enabled
dirk@625
   133
{
dirk@625
   134
    s_passiveModeEnabled = enabled;
dirk@625
   135
}
dirk@625
   136
andreas@416
   137
#pragma mark - DB PATHS
andreas@416
   138
dirk@187
   139
+ (void)initialize
dirk@187
   140
{
dirk@187
   141
    s_homeURL = [self createApplicationDirectory];
dirk@442
   142
    [self setHomeDirectory:s_homeURL]; // Important, defines $HOME and $TEMP for the engine
dirk@504
   143
    s_writeLock = [[NSLock alloc] init];
dirk@187
   144
}
dirk@187
   145
dirk@187
   146
+ (NSURL *)homeURL
dirk@187
   147
{
dirk@187
   148
    return s_homeURL;
dirk@187
   149
}
dirk@187
   150
dirk@187
   151
+ (NSURL *)createApplicationDirectory
dirk@187
   152
{
dirk@187
   153
    NSString *bundleID = [[NSBundle mainBundle] bundleIdentifier];
dirk@187
   154
    if (!bundleID) {
dirk@187
   155
        // This can happen in unit tests
dirk@187
   156
        bundleID = @"test";
dirk@187
   157
    }
dirk@187
   158
    NSFileManager *fm = [NSFileManager defaultManager];
dirk@187
   159
    NSURL *dirPath = nil;
andreas@268
   160
    
dirk@187
   161
    // Find the application support directory in the home directory.
dirk@187
   162
    NSArray *appSupportDir = [fm URLsForDirectory:NSApplicationSupportDirectory
dirk@187
   163
                                        inDomains:NSUserDomainMask];
dirk@187
   164
    if ([appSupportDir count] > 0)
dirk@187
   165
    {
dirk@187
   166
        // Append the bundle ID to the URL for the
dirk@187
   167
        // Application Support directory.
dirk@187
   168
        // Mainly needed for OS X, but doesn't do any harm on iOS
dirk@187
   169
        dirPath = [[appSupportDir objectAtIndex:0] URLByAppendingPathComponent:bundleID];
andreas@268
   170
        
dirk@187
   171
        // If the directory does not exist, this method creates it.
dirk@187
   172
        // This method is only available in OS X v10.7 and iOS 5.0 or later.
dirk@187
   173
        NSError *theError = nil;
dirk@187
   174
        if (![fm createDirectoryAtURL:dirPath withIntermediateDirectories:YES
dirk@187
   175
                           attributes:nil error:&theError])
dirk@187
   176
        {
dirk@187
   177
            // Handle the error.
dirk@187
   178
            return nil;
dirk@187
   179
        }
dirk@187
   180
    }
andreas@268
   181
    
dirk@187
   182
    return dirPath;
dirk@187
   183
}
dirk@187
   184
dirk@442
   185
+ (void)setHomeDirectory:(NSURL *)homeDir
dirk@187
   186
{
dirk@187
   187
    // create and set home directory
dirk@442
   188
    setenv("HOME", [[homeDir path] cStringUsingEncoding:NSUTF8StringEncoding], 1);
andreas@268
   189
    
dirk@187
   190
    // create and set temp directory
dirk@187
   191
    NSURL *tmpDirUrl = [NSURL fileURLWithPath:NSTemporaryDirectory() isDirectory:YES];
dirk@187
   192
    setenv("TEMP", [[tmpDirUrl path] cStringUsingEncoding:NSUTF8StringEncoding], 1);
dirk@187
   193
}
dirk@187
   194
andreas@276
   195
+ (NSString *)getBundlePathFor: (NSString *) filename
dirk@187
   196
{
dirk@187
   197
    return nil;
dirk@187
   198
}
dirk@187
   199
dirk@442
   200
+ (NSString *)copyAssetsIntoDocumentsDirectory:(NSBundle *)rootBundle
dirk@442
   201
                                    bundleName:(NSString *)bundleName
dirk@442
   202
                                      fileName:(NSString *)fileName {
andreas@268
   203
    
dirk@442
   204
    NSURL *homeUrl = s_homeURL;
dirk@187
   205
    NSString *documentsDirectory = [homeUrl path];
dirk@187
   206
    
dirk@187
   207
    if(!(documentsDirectory && bundleName && fileName))
dirk@187
   208
        return nil;
dirk@187
   209
    
dirk@187
   210
    // Check if the database file exists in the documents directory.
dirk@187
   211
    NSString *destinationPath = [documentsDirectory stringByAppendingPathComponent:fileName];
dirk@187
   212
    if (![[NSFileManager defaultManager] fileExistsAtPath:destinationPath]) {
dirk@187
   213
        // The file does not exist in the documents directory, so copy it from bundle now.
dirk@187
   214
        NSBundle *bundleObj = [NSBundle bundleWithPath:
dirk@187
   215
                               [[rootBundle resourcePath]
dirk@187
   216
                                stringByAppendingPathComponent: bundleName]];
dirk@187
   217
        if (!bundleObj)
dirk@187
   218
            return nil;
dirk@187
   219
        
dirk@187
   220
        NSString *sourcePath =[[bundleObj resourcePath] stringByAppendingPathComponent: fileName];
dirk@187
   221
        
dirk@187
   222
        NSError *error;
dirk@187
   223
        [[NSFileManager defaultManager]
dirk@187
   224
         copyItemAtPath:sourcePath toPath:destinationPath error:&error];
dirk@187
   225
        
dirk@187
   226
        // Check if any error occurred during copying and display it.
dirk@187
   227
        if (error != nil) {
dirk@187
   228
            NSLog(@"%@", [error localizedDescription]);
dirk@187
   229
            return nil;
dirk@187
   230
        }
dirk@187
   231
    }
dirk@187
   232
    return destinationPath;
dirk@187
   233
}
dirk@187
   234
dirk@187
   235
+ (void)setupTrustWordsDB:(NSBundle *)rootBundle{
dirk@442
   236
    NSString *systemDBPath = [PEPObjCAdapter
dirk@442
   237
                              copyAssetsIntoDocumentsDirectory:rootBundle
dirk@442
   238
                              bundleName:@"pEpTrustWords.bundle"
dirk@442
   239
                              fileName:@"system.db"];
dirk@187
   240
    if (SystemDB) {
dirk@187
   241
        free((void *) SystemDB);
dirk@187
   242
    }
dirk@187
   243
    SystemDB = strdup(systemDBPath.UTF8String);
dirk@187
   244
}
dirk@187
   245
dirk@187
   246
+ (void)setupTrustWordsDB
dirk@187
   247
{
dirk@187
   248
    [PEPObjCAdapter setupTrustWordsDB:[NSBundle mainBundle]];
dirk@187
   249
}
dirk@187
   250
dirk@187
   251
static NSMutableArray* boundSessions = nil;
dirk@187
   252
dirk@187
   253
+ (NSMutableArray*)boundSessions
dirk@187
   254
{
dirk@187
   255
    static dispatch_once_t once;
dirk@187
   256
    dispatch_once(&once, ^{
dirk@187
   257
        boundSessions =  [[NSMutableArray alloc] init];
dirk@187
   258
    });
dirk@187
   259
    return boundSessions;
dirk@187
   260
}
dirk@187
   261
dirk@504
   262
#pragma mark - sqlite locking
dirk@504
   263
dirk@504
   264
+ (void)lockWrite
dirk@504
   265
{
dirk@504
   266
    [s_writeLock lock];
dirk@504
   267
}
dirk@504
   268
dirk@504
   269
+ (void)unlockWrite
dirk@504
   270
{
dirk@504
   271
    [s_writeLock unlock];
dirk@504
   272
}
dirk@504
   273
dirk@504
   274
#pragma mark - Old keysync implementation
dirk@504
   275
dirk@187
   276
///////////////////////////////////////////////////////////////////////////////
dirk@187
   277
//  Keyserver and Identity lookup - ObjC part
dirk@187
   278
dirk@187
   279
static PEPQueue *lookupQueue = nil;
dirk@187
   280
static NSThread *lookupThread = nil;
dirk@187
   281
static NSConditionLock *lookupThreadJoinCond = nil;
dirk@187
   282
dirk@187
   283
+ (void)lookupThreadRoutine:(id)object
dirk@187
   284
{
dirk@187
   285
    [lookupThreadJoinCond lock];
andreas@268
   286
    
dirk@187
   287
    // FIXME: do_KeyManagement asserts if management is null.
dirk@187
   288
    do_keymanagement(retrieve_next_identity, "NOTNULL" /* (__bridge void *)queue */);
dirk@187
   289
    
dirk@187
   290
    // Set and signal join()
dirk@187
   291
    [lookupThreadJoinCond unlockWithCondition:YES];
dirk@187
   292
}
dirk@187
   293
dirk@187
   294
+ (void)startKeyserverLookup
dirk@187
   295
{
dirk@187
   296
    if (!lookupQueue)
dirk@187
   297
    {
dirk@187
   298
        lookupQueue = [[PEPQueue alloc]init];
dirk@187
   299
        
dirk@187
   300
        // There is no join() call on NSThreads.
dirk@187
   301
        lookupThreadJoinCond = [[NSConditionLock alloc] initWithCondition:NO];
dirk@187
   302
        
dirk@187
   303
        lookupThread = [[NSThread alloc] initWithTarget:self selector:@selector(lookupThreadRoutine:) object:nil];
dirk@187
   304
        [lookupThread start];
dirk@187
   305
    }
dirk@187
   306
}
dirk@187
   307
dirk@187
   308
+ (void)stopKeyserverLookup
dirk@187
   309
{
dirk@187
   310
    
dirk@187
   311
    if (lookupQueue)
dirk@187
   312
    {
dirk@187
   313
        // Flush queue and kick the consumer
dirk@187
   314
        [lookupQueue kill];
dirk@187
   315
        
dirk@187
   316
        // Thread then bailout. Wait for that.
dirk@187
   317
        [lookupThreadJoinCond lockWhenCondition:YES];
dirk@187
   318
        [lookupThreadJoinCond unlock];
dirk@187
   319
        
dirk@187
   320
        lookupThread = nil;
dirk@187
   321
        lookupQueue = nil;
dirk@187
   322
        lookupThreadJoinCond = nil;
dirk@187
   323
    }
dirk@187
   324
}
dirk@187
   325
dirk@187
   326
+ (void)registerExamineFunction:(PEP_SESSION)session
dirk@187
   327
{
dirk@187
   328
    register_examine_function(session, examine_identity, NULL /* (__bridge void *)queue */);
dirk@187
   329
}
dirk@187
   330
dirk@187
   331
+ (PEPQueue*)getLookupQueue
dirk@187
   332
{
dirk@187
   333
    return lookupQueue;
dirk@187
   334
}
dirk@187
   335
dirk@331
   336
///////////////////////////////////////////////////////////////////////////////
dirk@331
   337
// Sync - ObjC part
dirk@331
   338
dirk@331
   339
static PEPQueue *syncQueue = nil;
dirk@331
   340
static NSThread *syncThread = nil;
dirk@331
   341
static NSConditionLock *syncThreadJoinCond = nil;
dirk@331
   342
static PEP_SESSION sync_session = NULL;
dirk@331
   343
static id <PEPSyncDelegate> syncDelegate = nil;
dirk@331
   344
dirk@331
   345
dirk@331
   346
+ (void)syncThreadRoutine:(id)object
dirk@331
   347
{
dirk@331
   348
    [syncThreadJoinCond lock];
dirk@331
   349
    
dirk@331
   350
    
dirk@506
   351
    do_sync_protocol(sync_session,
dirk@506
   352
                     /* "object" : notifying, sending (unused) */
dirk@506
   353
                     "NOTNULL");
dirk@331
   354
    
dirk@331
   355
    // TODO : log something if status not as expected
dirk@331
   356
dirk@331
   357
    [syncThreadJoinCond unlockWithCondition:YES];
dirk@331
   358
}
dirk@331
   359
dirk@331
   360
+ (void)attachSyncSession:(PEP_SESSION)session
dirk@331
   361
{
dirk@331
   362
    if(sync_session)
dirk@331
   363
        attach_sync_session(session, sync_session);
dirk@331
   364
}
dirk@331
   365
dirk@331
   366
+ (void)detachSyncSession:(PEP_SESSION)session
dirk@331
   367
{
dirk@331
   368
    detach_sync_session(session);
dirk@331
   369
}
dirk@331
   370
dirk@331
   371
+ (void)startSync:(id <PEPSyncDelegate>)delegate;
dirk@331
   372
{
dirk@331
   373
    syncDelegate = delegate;
dirk@331
   374
    
dirk@333
   375
    if (!syncQueue) {
dirk@333
   376
        syncQueue = [[PEPQueue alloc] init];
dirk@331
   377
        
dirk@331
   378
        syncThreadJoinCond = [[NSConditionLock alloc] initWithCondition:NO];
dirk@331
   379
        
dirk@504
   380
        [self lockWrite];
dirk@331
   381
        PEP_STATUS status = init(&sync_session);
dirk@504
   382
        [self unlockWrite];
dirk@331
   383
        if (status != PEP_STATUS_OK) {
dirk@331
   384
            return;
dirk@331
   385
        }
dirk@331
   386
        
dirk@331
   387
        register_sync_callbacks(sync_session,
dirk@331
   388
                                /* "management" : queuing (unused) */
dirk@331
   389
                                "NOTNULL",
dirk@331
   390
                                message_to_send,
dirk@331
   391
                                notify_handshake,
dirk@331
   392
                                inject_sync_msg,
dirk@331
   393
                                retrieve_next_sync_msg);
dirk@331
   394
        
dirk@331
   395
        syncThread = [[NSThread alloc]
dirk@331
   396
                      initWithTarget:self
dirk@331
   397
                      selector:@selector(syncThreadRoutine:)
dirk@331
   398
                      object:nil];
dirk@331
   399
        
dirk@331
   400
        [syncThread start];
dirk@331
   401
    }
dirk@331
   402
    
dirk@331
   403
    NSMutableArray* sessionList = [PEPObjCAdapter boundSessions];
dirk@331
   404
    NSValue* v;
dirk@331
   405
    PEPInternalSession* session;
dirk@331
   406
    @synchronized (sessionList) {
dirk@331
   407
        for (v in sessionList) {
dirk@331
   408
            session = [v nonretainedObjectValue];
dirk@331
   409
            [PEPObjCAdapter attachSyncSession:[session session]];
dirk@331
   410
        }
dirk@331
   411
    }
dirk@331
   412
}
dirk@331
   413
dirk@331
   414
+ (void)stopSync
dirk@331
   415
{
dirk@331
   416
    NSMutableArray* sessionList = [PEPObjCAdapter boundSessions];
dirk@331
   417
    NSValue* v;
dirk@331
   418
    PEPInternalSession* session;
dirk@331
   419
    @synchronized (sessionList) {
dirk@331
   420
        for (v in sessionList) {
dirk@331
   421
            session = [v nonretainedObjectValue];
dirk@331
   422
            [PEPObjCAdapter detachSyncSession:[session session]];
dirk@331
   423
        }
dirk@331
   424
    }
dirk@331
   425
    
dirk@331
   426
    syncDelegate = nil;
dirk@331
   427
    
dirk@331
   428
    if (syncQueue)
dirk@331
   429
    {
dirk@331
   430
        [syncQueue purge:^(id item){
dirk@331
   431
            sync_msg_t *msg = [item pointerValue];
dirk@331
   432
            free_sync_msg(msg);
dirk@331
   433
        }];
dirk@331
   434
        
dirk@331
   435
        [syncThreadJoinCond lockWhenCondition:YES];
dirk@331
   436
        [syncThreadJoinCond unlock];
dirk@331
   437
        
dirk@504
   438
        [self lockWrite];
dirk@331
   439
        release(sync_session);
dirk@504
   440
        [self unlockWrite];
dirk@504
   441
dirk@331
   442
        sync_session = NULL;
dirk@331
   443
        syncThread = nil;
dirk@331
   444
        syncQueue = nil;
dirk@331
   445
        syncThreadJoinCond = nil;
dirk@331
   446
    }
dirk@331
   447
}
dirk@331
   448
dirk@331
   449
+ (PEPQueue*)getSyncQueue
dirk@331
   450
{
dirk@331
   451
    return syncQueue;
dirk@331
   452
}
dirk@331
   453
dirk@331
   454
+ (id <PEPSyncDelegate>)getSyncDelegate
dirk@331
   455
{
dirk@331
   456
    return syncDelegate;
dirk@331
   457
}
dirk@331
   458
dirk@331
   459
+ (void)bindSession:(PEPInternalSession*)session
dirk@331
   460
{
dirk@331
   461
    NSMutableArray* sessionList = [PEPObjCAdapter boundSessions];
dirk@331
   462
    @synchronized (sessionList) {
dirk@331
   463
        [sessionList addObject:[NSValue valueWithNonretainedObject:session]];
dirk@331
   464
    }
dirk@331
   465
    
dirk@331
   466
    [PEPObjCAdapter registerExamineFunction:[session session]];
dirk@331
   467
    [PEPObjCAdapter attachSyncSession:[session session]];
dirk@331
   468
}
dirk@331
   469
dirk@331
   470
+ (void)unbindSession:(PEPInternalSession*)session
dirk@331
   471
{
dirk@331
   472
    [PEPObjCAdapter detachSyncSession:[session session]];
dirk@331
   473
    
dirk@331
   474
    NSMutableArray* sessionList = [PEPObjCAdapter boundSessions];
dirk@331
   475
    @synchronized (sessionList) {
dirk@331
   476
        [sessionList removeObject:[NSValue valueWithNonretainedObject:session]];
dirk@331
   477
    }
dirk@331
   478
}
dirk@331
   479
dirk@484
   480
+ (PEPMessage * _Nullable)mimeDecode:(NSString * _Nonnull)mimeText
dirk@484
   481
                          pEpMessage:(PEPMessage *_Nullable * _Nonnull)pEpMessage
dirk@484
   482
                               error:(NSError * _Nonnull * _Nullable)error
dirk@484
   483
{
dirk@484
   484
    message *dstMsg = NULL;
dirk@484
   485
    const char *utfString = [[mimeText precomposedStringWithCanonicalMapping] UTF8String];
dirk@484
   486
    PEP_STATUS status = mime_decode_message(utfString, strlen(utfString), &dstMsg);
dirk@484
   487
dirk@484
   488
    if (status == PEP_STATUS_OK) {
dirk@484
   489
        if (dstMsg) {
dirk@484
   490
            return pEpMessageFromStruct(dstMsg);
dirk@484
   491
        } else {
dirk@484
   492
            return nil;
dirk@484
   493
        }
dirk@484
   494
    } else {
dirk@484
   495
        if (error) {
dirk@484
   496
            *error = [NSError errorWithPEPStatus:status];
dirk@484
   497
        }
dirk@484
   498
        return nil;
dirk@484
   499
    }
dirk@484
   500
}
dirk@484
   501
dirk@187
   502
@end