1*7c478bd9Sstevel@tonic-gate #pragma ident "%Z%%M% %I% %E% SMI" 2*7c478bd9Sstevel@tonic-gate 3*7c478bd9Sstevel@tonic-gate /* 4*7c478bd9Sstevel@tonic-gate * The contents of this file are subject to the Netscape Public 5*7c478bd9Sstevel@tonic-gate * License Version 1.1 (the "License"); you may not use this file 6*7c478bd9Sstevel@tonic-gate * except in compliance with the License. You may obtain a copy of 7*7c478bd9Sstevel@tonic-gate * the License at http://www.mozilla.org/NPL/ 8*7c478bd9Sstevel@tonic-gate * 9*7c478bd9Sstevel@tonic-gate * Software distributed under the License is distributed on an "AS 10*7c478bd9Sstevel@tonic-gate * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or 11*7c478bd9Sstevel@tonic-gate * implied. See the License for the specific language governing 12*7c478bd9Sstevel@tonic-gate * rights and limitations under the License. 13*7c478bd9Sstevel@tonic-gate * 14*7c478bd9Sstevel@tonic-gate * The Original Code is Mozilla Communicator client code, released 15*7c478bd9Sstevel@tonic-gate * March 31, 1998. 16*7c478bd9Sstevel@tonic-gate * 17*7c478bd9Sstevel@tonic-gate * The Initial Developer of the Original Code is Netscape 18*7c478bd9Sstevel@tonic-gate * Communications Corporation. Portions created by Netscape are 19*7c478bd9Sstevel@tonic-gate * Copyright (C) 1998-1999 Netscape Communications Corporation. All 20*7c478bd9Sstevel@tonic-gate * Rights Reserved. 21*7c478bd9Sstevel@tonic-gate * 22*7c478bd9Sstevel@tonic-gate * Contributor(s): 23*7c478bd9Sstevel@tonic-gate */ 24*7c478bd9Sstevel@tonic-gate 25*7c478bd9Sstevel@tonic-gate /* 26*7c478bd9Sstevel@tonic-gate * LDAP tools fileurl.h -- defines for file URL functions. 27*7c478bd9Sstevel@tonic-gate * Used by ldapmodify. 28*7c478bd9Sstevel@tonic-gate */ 29*7c478bd9Sstevel@tonic-gate 30*7c478bd9Sstevel@tonic-gate /* 31*7c478bd9Sstevel@tonic-gate * ldaptool_fileurl2path() convert a file URL to a local path. 32*7c478bd9Sstevel@tonic-gate * 33*7c478bd9Sstevel@tonic-gate * If successful, LDAPTOOL_FILEURL_SUCCESS is returned and *localpathp is 34*7c478bd9Sstevel@tonic-gate * set point to an allocated string. If not, a different LDAPTOOL_FILEURL_ 35*7c478bd9Sstevel@tonic-gate * error code is returned. 36*7c478bd9Sstevel@tonic-gate */ 37*7c478bd9Sstevel@tonic-gate int ldaptool_fileurl2path( const char *fileurl, char **localpathp ); 38*7c478bd9Sstevel@tonic-gate 39*7c478bd9Sstevel@tonic-gate 40*7c478bd9Sstevel@tonic-gate /* 41*7c478bd9Sstevel@tonic-gate * Convert a local path to a file URL. 42*7c478bd9Sstevel@tonic-gate * 43*7c478bd9Sstevel@tonic-gate * If successful, LDAPTOOL_FILEURL_SUCCESS is returned and *urlp is 44*7c478bd9Sstevel@tonic-gate * set point to an allocated string. If not, a different LDAPTOOL_FILEURL_ 45*7c478bd9Sstevel@tonic-gate * error code is returned. At present, the only possible error is 46*7c478bd9Sstevel@tonic-gate * LDAPTOOL_FILEURL_NOMEMORY. 47*7c478bd9Sstevel@tonic-gate * 48*7c478bd9Sstevel@tonic-gate */ 49*7c478bd9Sstevel@tonic-gate int ldaptool_path2fileurl( char *path, char **urlp ); 50*7c478bd9Sstevel@tonic-gate 51*7c478bd9Sstevel@tonic-gate 52*7c478bd9Sstevel@tonic-gate /* 53*7c478bd9Sstevel@tonic-gate * Populate *bvp from "value" of length "vlen." 54*7c478bd9Sstevel@tonic-gate * 55*7c478bd9Sstevel@tonic-gate * If recognize_url_syntax is non-zero, :<fileurl is recognized. 56*7c478bd9Sstevel@tonic-gate * If always_try_file is recognized and no file URL was found, an 57*7c478bd9Sstevel@tonic-gate * attempt is made to stat and read the value as if it were the name 58*7c478bd9Sstevel@tonic-gate * of a file. 59*7c478bd9Sstevel@tonic-gate * 60*7c478bd9Sstevel@tonic-gate * If reporterrs is non-zero, specific error messages are printed to 61*7c478bd9Sstevel@tonic-gate * stderr. 62*7c478bd9Sstevel@tonic-gate * 63*7c478bd9Sstevel@tonic-gate * If successful, LDAPTOOL_FILEURL_SUCCESS is returned and bvp->bv_len 64*7c478bd9Sstevel@tonic-gate * and bvp->bv_val are set (the latter is set to malloc'd memory). 65*7c478bd9Sstevel@tonic-gate * Upon failure, a different LDAPTOOL_FILEURL_ error code is returned. 66*7c478bd9Sstevel@tonic-gate */ 67*7c478bd9Sstevel@tonic-gate int ldaptool_berval_from_ldif_value( const char *value, int vlen, 68*7c478bd9Sstevel@tonic-gate struct berval *bvp, int recognize_url_syntax, int always_try_file, 69*7c478bd9Sstevel@tonic-gate int reporterrs ); 70*7c478bd9Sstevel@tonic-gate 71*7c478bd9Sstevel@tonic-gate 72*7c478bd9Sstevel@tonic-gate /* 73*7c478bd9Sstevel@tonic-gate * Map an LDAPTOOL_FILEURL_ error code to an LDAP error code (crude). 74*7c478bd9Sstevel@tonic-gate */ 75*7c478bd9Sstevel@tonic-gate int ldaptool_fileurlerr2ldaperr( int lderr ); 76*7c478bd9Sstevel@tonic-gate 77*7c478bd9Sstevel@tonic-gate 78*7c478bd9Sstevel@tonic-gate /* 79*7c478bd9Sstevel@tonic-gate * Possible return codes for the functions declared in this file: 80*7c478bd9Sstevel@tonic-gate */ 81*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_SUCCESS 0 82*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_NOTAFILEURL 1 83*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_MISSINGPATH 2 84*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_NONLOCAL 3 85*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_NOMEMORY 4 86*7c478bd9Sstevel@tonic-gate #define LDAPTOOL_FILEURL_FILEIOERROR 5 87