lib/util_str.c

String utilities. [詳細]

ソースコードを見る。

関数
static BOOL	next_token_internal (const char **ptr, char *buff, const char *sep, size_t bufsize, BOOL ltrim)
	Internal function to get the next token from a string, return False if none found.
BOOL	next_token (const char **ptr, char *buff, const char *sep, size_t bufsize)
BOOL	next_token_no_ltrim (const char **ptr, char *buff, const char *sep, size_t bufsize)
BOOL	next_token_nr (const char **ptr, char *buff, const char *sep, size_t bufsize)
void	set_first_token (char *ptr)
char **	toktocliplist (int *ctok, const char *sep)
	Convert list of tokens to array; dependent on above routine.
int	StrCaseCmp (const char *s, const char *t)
	Case insensitive string compararison.
int	StrnCaseCmp (const char *s, const char *t, size_t n)
	Case insensitive string compararison, length limited.
BOOL	strequal (const char *s1, const char *s2)
	Compare 2 strings.
BOOL	strnequal (const char *s1, const char *s2, size_t n)
	Compare 2 strings up to and including the nth char.
BOOL	strcsequal (const char *s1, const char *s2)
	Compare 2 strings (case sensitive).
int	strwicmp (const char *psz1, const char *psz2)
	Do a case-insensitive, whitespace-ignoring string compare.
char *	strupper_static (const char *s)
	Convert a string to upper case, but don't modify it.
void	strnorm (char *s, int case_default)
	Convert a string to "normal" form.
BOOL	strisnormal (const char *s, int case_default)
	Check if a string is in "normal" case.
void	string_replace (char *s, char oldc, char newc)
	String replace.
char *	push_skip_string (char *buf)
	Skip past some strings in a buffer - old version - no checks.
char *	skip_string (const char *base, size_t len, char *buf)
	Skip past a string in a buffer.
size_t	str_charnum (const char *s)
	Count the number of characters in a string.
size_t	str_ascii_charnum (const char *s)
	Count the number of characters in a string.
BOOL	trim_char (char *s, char cfront, char cback)
BOOL	trim_string (char *s, const char *front, const char *back)
	Trim the specified elements off the front and back of a string.
BOOL	strhasupper (const char *s)
	Does a string have any uppercase chars in it?
BOOL	strhaslower (const char *s)
	Does a string have any lowercase chars in it?
size_t	count_chars (const char *s, char c)
	Find the number of 'c' chars in a string
char *	safe_strcpy_fn (const char *fn, int line, char *dest, const char *src, size_t maxlength)
	Safe string copy into a known length string.
char *	safe_strcat_fn (const char *fn, int line, char *dest, const char *src, size_t maxlength)
	Safe string cat into a string.
char *	alpha_strcpy_fn (const char *fn, int line, char *dest, const char *src, const char *other_safe_chars, size_t maxlength)
	Paranoid strcpy into a buffer of given length (includes terminating zero.
char *	StrnCpy_fn (const char *fn, int line, char *dest, const char *src, size_t n)
	Like strncpy but always null terminates.
static char *	strncpyn (char *dest, const char *src, size_t n, char c)
	Like strncpy but copies up to the character marker.
size_t	strhex_to_str (char *p, size_t len, const char *strhex)
	Routine to get hex characters and turn them into a 16 byte array.
DATA_BLOB	strhex_to_data_blob (TALLOC_CTX *mem_ctx, const char *strhex)
char *	hex_encode (TALLOC_CTX *mem_ctx, const unsigned char *buff_in, size_t len)
	Routine to print a buffer as HEX digits, into an allocated string.
BOOL	in_list (const char *s, const char *list, BOOL casesensitive)
	Check if a string is part of a list.
static BOOL	string_init (char **dest, const char *src)
	Set a string value, allocing the space for the string
void	string_free (char **s)
	Free a string value.
BOOL	string_set (char **dest, const char *src)
	Set a string value, deallocating any existing space, and allocing the space for the string
void	string_sub2 (char *s, const char *pattern, const char *insert, size_t len, BOOL remove_unsafe_characters, BOOL replace_once, BOOL allow_trailing_dollar)
	Substitute a string for a pattern in another string.
void	string_sub_once (char *s, const char *pattern, const char *insert, size_t len)
void	string_sub (char *s, const char *pattern, const char *insert, size_t len)
void	fstring_sub (char *s, const char *pattern, const char *insert)
void	pstring_sub (char *s, const char *pattern, const char *insert)
char *	realloc_string_sub (char *string, const char *pattern, const char *insert)
	Similar to string_sub, but it will accept only allocated strings and may realloc them so pay attention at what you pass on no pointers inside strings, no pstrings or const may be passed as string.
char *	talloc_string_sub (TALLOC_CTX *mem_ctx, const char *src, const char *pattern, const char *insert)
void	all_string_sub (char *s, const char *pattern, const char *insert, size_t len)
	Similar to string_sub() but allows for any character to be substituted.
static smb_ucs2_t *	all_string_sub_w (const smb_ucs2_t *s, const smb_ucs2_t *pattern, const smb_ucs2_t *insert)
	Similar to all_string_sub but for unicode strings.
smb_ucs2_t *	all_string_sub_wa (smb_ucs2_t *s, const char *pattern, const char *insert)
static void	split_at_last_component (char *path, char *front, char sep, char *back)
	Splits out the front and back at a separator.
const char *	octal_string (int i)
	Write an octal as a string.
char *	string_truncate (char *s, unsigned int length)
	Truncate a string at a specified length.
char *	strchr_m (const char *src, char c)
	Strchr and strrchr_m are very hard to do on general multi-byte strings.
char *	strrchr_m (const char *s, char c)
char *	strnrchr_m (const char *s, char c, unsigned int n)
char *	strstr_m (const char *src, const char *findstr)
void	strlower_m (char *s)
	Convert a string to lower case.
void	strupper_m (char *s)
	Convert a string to upper case.
size_t	strlen_m (const char *s)
	Count the number of UCS2 characters in a string.
size_t	strlen_m_term (const char *s)
	Count the number of UCS2 characters in a string including the null terminator.
size_t	strlen_m_term_null (const char *s)
char *	binary_string_rfc2254 (char *buf, int len)
	Return a RFC2254 binary string representation of a buffer.
char *	binary_string (char *buf, int len)
int	pstr_sprintf (pstring s, const char *fmt,...)
	Just a typesafety wrapper for snprintf into a pstring.
int	fstr_sprintf (fstring s, const char *fmt,...)
	Just a typesafety wrapper for snprintf into a fstring.
static char **	str_list_make_internal (TALLOC_CTX *mem_ctx, const char *string, const char *sep)
char **	str_list_make_talloc (TALLOC_CTX *mem_ctx, const char *string, const char *sep)
char **	str_list_make (const char *string, const char *sep)
BOOL	str_list_copy (char ***dest, const char **src)
BOOL	str_list_compare (char **list1, char **list2)
	Return true if all the elements of the list match exactly.
static void	str_list_free_internal (TALLOC_CTX *mem_ctx, char ***list)
void	str_list_free_talloc (TALLOC_CTX *mem_ctx, char ***list)
void	str_list_free (char ***list)
int	str_list_count (const char **list)
BOOL	str_list_sub_basic (char **list, const char *smb_name, const char *domain_name)
BOOL	str_list_substitute (char **list, const char *pattern, const char *insert)
char *	ipstr_list_add (char **ipstr_list, const struct ip_service *service)
	Add ip string representation to ipstr list.
char *	ipstr_list_make (char **ipstr_list, const struct ip_service *ip_list, int ip_count)
	Allocate and initialise an ipstr list using ip adresses passed as arguments.
int	ipstr_list_parse (const char *ipstr_list, struct ip_service **ip_list)
	Parse given ip string list into array of ip addresses (as ip_service structures) e.g.
void	ipstr_list_free (char *ipstr_list)
	Safely free ip string list
void	rfc1738_unescape (char *buf)
	Unescape a URL encoded string, in place.
DATA_BLOB	base64_decode_data_blob (const char *s)
	Decode a base64 string into a DATA_BLOB - simple and slow algorithm
void	base64_decode_inplace (char *s)
	Decode a base64 string in-place - wrapper for the above
char *	base64_encode_data_blob (DATA_BLOB data)
	Encode a base64 string into a malloc()ed string caller to free.
SMB_BIG_UINT	STR_TO_SMB_BIG_UINT (const char *nptr, const char **entptr)
SMB_OFF_T	conv_str_size (const char *str)
void	string_append (char **left, const char *right)
BOOL	add_string_to_array (TALLOC_CTX *mem_ctx, const char *str, const char ***strings, int *num)
void	sprintf_append (TALLOC_CTX *mem_ctx, char **string, ssize_t *len, size_t *bufsize, const char *fmt,...)
char *	sstring_sub (const char *src, char front, char back)
BOOL	validate_net_name (const char *name, const char *invalid_chars, int max_len)
size_t	ascii_len_n (const char *src, size_t n)
	return the number of bytes occupied by a buffer in ASCII format the result includes the null termination limited by 'n' bytes
size_t	utf16_len (const void *buf)
	return the number of bytes occupied by a buffer in CH_UTF16 format the result includes the null termination
size_t	utf16_len_n (const void *src, size_t n)
	return the number of bytes occupied by a buffer in CH_UTF16 format the result includes the null termination limited by 'n' bytes
char *	escape_shell_string (const char *src)
変数
static const char *	last_ptr = NULL
	This is like next_token but is not re-entrant and "remembers" the first parameter so you can pass NULL.
static uint16	tmpbuf [sizeof(pstring)]
static const char *	null_string = ""
static const char *	b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"

---

説明

String utilities.

util_str.c で定義されています。

---

関数

static BOOL next_token_internal	(	const char **	ptr,
		char *	buff,
		const char *	sep,
		size_t	bufsize,
		BOOL	ltrim
	)			[static]

Internal function to get the next token from a string, return False if none found.

Handles double-quotes. This is the work horse function called by next_token() and next_token_no_ltrim().

Based on a routine by GJC@VILLAGE.COM. Extensively modified by Andrew.Tridgell@anu.edu.au

util_str.c の 40 行で定義されています。

参照先 len・strchr_m().

参照元 next_token()・next_token_no_ltrim().

{
        char *s;
        char *pbuf;
        BOOL quoted;
        size_t len=1;

        if (!ptr)
                return(False);

        s = (char *)*ptr;

        /* default to simple separators */
        if (!sep)
                sep = " \t\n\r";

        /* find the first non sep char, if left-trimming is requested */
        if (ltrim) {
                while (*s && strchr_m(sep,*s))
                        s++;
        }
        
        /* nothing left? */
        if (! *s)
                return(False);
        
        /* copy over the token */
        pbuf = buff;
        for (quoted = False; len < bufsize && *s && (quoted || !strchr_m(sep,*s)); s++) {
                if ( *s == '\"' ) {
                        quoted = !quoted;
                } else {
                        len++;
                        *pbuf++ = *s;
                }
        }
        
        *ptr = (*s) ? s+1 : s;  
        *pbuf = 0;
        
        return(True);
}

BOOL next_token	(	const char **	ptr,
		char *	buff,
		const char *	sep,
		size_t	bufsize
	)

util_str.c の 92 行で定義されています。

参照先 next_token_internal().

参照元 ads_gpo_explode_filesyspath()・ads_gpo_prepare_local_store()・announce_remote()・browse_sync_remote()・collect_aliasmem()・complete_sync()・do_cmd()・do_global_checks()・dos_attr_parse()・fill_grent()・get_dc_list()・get_server_info()・get_user_tokens()・getlmhostsent()・in_list()・init_dom_sid2s()・init_registry_data()・initialise_wins()・internal_resolve_name()・ipstr_list_parse()・ldapsam_get_seq_num()・make_pw_chat()・net_copy_driverfile()・next_token_nr()・one_alias_membership()・open_sockets_smbd()・parse_ace()・parse_lpq_aix()・parse_lpq_hpux()・parse_lpq_lprng()・parse_lpq_plp()・parse_lpq_qnx()・parse_lpq_sysv()・parse_lpq_vlp()・parse_usershare_acl()・print_domain_groups()・print_domain_users()・process_cmd()・py_enum_domain_groups()・py_enum_domain_users()・py_enum_trust_dom()・reg_split_hive()・sam_account_ok()・sec_desc_parse()・server_cryptkey()・set_socket_options()・smbc_parse_path()・str_list_make_internal()・talktochild()・wbinfo_list_domains()・wbinfo_lookuprids().

{
    return next_token_internal(ptr, buff, sep, bufsize, True);
}

BOOL next_token_no_ltrim	(	const char **	ptr,
		char *	buff,
		const char *	sep,
		size_t	bufsize
	)

util_str.c の 102 行で定義されています。

参照先 next_token_internal().

参照元 smbc_parse_path().

{
    return next_token_internal(ptr, buff, sep, bufsize, False);
}

BOOL next_token_nr	(	const char **	ptr,
		char *	buff,
		const char *	sep,
		size_t	bufsize
	)

util_str.c の 118 行で定義されています。

参照先 last_ptr・next_token().

参照元 cmd_altname()・cmd_archive()・cmd_cancel()・cmd_cd()・cmd_chmod()・cmd_chown()・cmd_close()・cmd_del()・cmd_dir()・cmd_du()・cmd_get()・cmd_getfacl()・cmd_hardlink()・cmd_help()・cmd_lcd()・cmd_link()・cmd_lock()・cmd_logon()・cmd_mget()・cmd_mkdir()・cmd_more()・cmd_mput()・cmd_newer()・cmd_open()・cmd_posix_mkdir()・cmd_posix_open()・cmd_posix_rmdir()・cmd_posix_unlink()・cmd_print()・cmd_put()・cmd_reget()・cmd_rename()・cmd_reput()・cmd_rmdir()・cmd_select()・cmd_stat()・cmd_symlink()・cmd_unlock()・cmd_vuid()・cmd_wdel()・cmd_wks_query_info()・process_command_string()・process_stdin()・writetarheader().

{
        BOOL ret;
        if (!ptr)
                ptr = &last_ptr;

        ret = next_token(ptr, buff, sep, bufsize);
        last_ptr = *ptr;
        return ret;     
}

void set_first_token

(

char *

ptr

)

util_str.c の 131 行で定義されています。

参照先 last_ptr.

参照元 run_enums_test()・run_ntlogin_test().

{
        last_ptr = ptr;
}

char** toktocliplist	(	int *	ctok,
		const char *	sep
	)

Convert list of tokens to array; dependent on above routine.

Uses last_ptr from above - bit of a hack.

util_str.c の 141 行で定義されています。

参照先 last_ptr・strchr_m().

参照元 writetarheader().

{
        char *s=(char *)last_ptr;
        int ictok=0;
        char **ret, **iret;

        if (!sep)
                sep = " \t\n\r";

        while(*s && strchr_m(sep,*s))
                s++;

        /* nothing left? */
        if (!*s)
                return(NULL);

        do {
                ictok++;
                while(*s && (!strchr_m(sep,*s)))
                        s++;
                while(*s && strchr_m(sep,*s))
                        *s++=0;
        } while(*s);
        
        *ctok=ictok;
        s=(char *)last_ptr;
        
        if (!(ret=iret=SMB_MALLOC_ARRAY(char *,ictok+1)))
                return NULL;
        
        while(ictok--) {    
                *iret++=s;
                if (ictok > 0) {
                        while(*s++)
                                ;
                        while(!*s)
                                s++;
                }
        }

        ret[*ctok] = NULL;
        return ret;
}

int StrCaseCmp	(	const char *	s,
		const char *	t
	)

Case insensitive string compararison.

iconv does not directly give us a way to compare strings in arbitrary unix character sets -- all we can is convert and then compare. This is expensive.

As an optimization, we do a first pass that considers only the prefix of the strings that is entirely 7-bit. Within this, we check whether they have the same value.

Hopefully this will often give the answer without needing to copy. In particular it should speed comparisons to literal ascii strings or comparisons of strings that are "obviously" different.

If we find a non-ascii character we fall back to converting via iconv.

This should never be slower than convering the whole thing, and often faster.

A different optimization would be to compare for bitwise equality in the binary encoding. (It would be possible thought hairy to do both simultaneously.) But in that case if they turn out to be different, we'd need to restart the whole thing.

Even better is to implement strcasecmp for each encoding and use a function pointer.

util_str.c の 214 行で定義されています。

参照先 push_ucs2_allocate()・size・strcasecmp_w()・toupper_ascii().

参照元 ads_dump_field()・cacl_get()・check_privilege_for_user()・cmd_listcommands()・cmd_samr_delete_alias()・cmd_samr_enum_als_groups()・cmd_samr_lookup_names()・cmd_samr_lookup_rids()・cmd_samr_query_aliasmem()・cmd_samr_query_useraliases()・cmd_spoolss_get_short_archi()・exact_match()・fetch_reg_keys_specific()・get_driver_3_param()・get_short_archi()・getprinterdata_printer_server()・hashrec_cmp()・in_list()・lookup()・main()・map_regval_to_ads()・ms_fnmatch()・name_to_fqdn()・net_groupmap_list()・net_lookup()・net_run_function()・net_run_function2()・pathtree_birth_child()・pathtree_find_child()・rpc_trustdom_list()・rpc_trustdom_vampire()・smbc_getxattr_ctx()・smbc_removexattr_ctx()・smbc_setxattr_ctx()・smbldap_make_mod()・strequal()・usergrp_display()・win_election().

{

        const char *ps, *pt;
        size_t size;
        smb_ucs2_t *buffer_s, *buffer_t;
        int ret;

        for (ps = s, pt = t; ; ps++, pt++) {
                char us, ut;

                if (!*ps && !*pt)
                        return 0; /* both ended */
                else if (!*ps)
                        return -1; /* s is a prefix */
                else if (!*pt)
                        return +1; /* t is a prefix */
                else if ((*ps & 0x80) || (*pt & 0x80))
                        /* not ascii anymore, do it the hard way from here on in */
                        break;

                us = toupper_ascii(*ps);
                ut = toupper_ascii(*pt);
                if (us == ut)
                        continue;
                else if (us < ut)
                        return -1;
                else if (us > ut)
                        return +1;
        }

        size = push_ucs2_allocate(&buffer_s, ps);
        if (size == (size_t)-1) {
                return strcmp(ps, pt); 
                /* Not quite the right answer, but finding the right one
                   under this failure case is expensive, and it's pretty close */
        }
        
        size = push_ucs2_allocate(&buffer_t, pt);
        if (size == (size_t)-1) {
                SAFE_FREE(buffer_s);
                return strcmp(ps, pt); 
                /* Not quite the right answer, but finding the right one
                   under this failure case is expensive, and it's pretty close */
        }
        
        ret = strcasecmp_w(buffer_s, buffer_t);
        SAFE_FREE(buffer_s);
        SAFE_FREE(buffer_t);
        return ret;
}

int StrnCaseCmp	(	const char *	s,
		const char *	t,
		size_t	n
	)

Case insensitive string compararison, length limited.

util_str.c の 270 行で定義されています。

参照先 unix_strupper().

参照元 alloc_sub_basic()・cacl_get()・delete_all_printer_data()・dos_attr_parse()・get_printer_subkeys()・get_sid_from_input()・get_sid_from_name()・main()・net_ads_join()・net_groupmap_add()・net_groupmap_delete()・net_groupmap_list()・net_groupmap_modify()・parse_ace()・regkey_open_internal()・sec_desc_parse()・smbc_getxattr_ctx()・smbc_removexattr_ctx()・smbc_setxattr_ctx()・startsmbfilepwent()・strnequal().

{
        pstring buf1, buf2;
        unix_strupper(s, strlen(s)+1, buf1, sizeof(buf1));
        unix_strupper(t, strlen(t)+1, buf2, sizeof(buf2));
        return strncmp(buf1,buf2,n);
}

BOOL strequal	(	const char *	s1,
		const char *	s2
	)

Compare 2 strings.

覚え書き:

The comparison is case-insensitive.

util_str.c の 283 行で定義されています。

参照先 StrCaseCmp().

参照元 _dfs_Remove()・_net_sam_logon_internal()・_reg_query_value()・_samr_get_dispenum_index()・_samr_lookup_domain()・_samr_set_aliasinfo()・_spoolss_getform()・_spoolss_getprinterdata()・_spoolss_setprinterdata()・_srv_net_sess_del()・_srv_net_share_add()・_srv_net_share_del()・_srv_net_share_set_info()・add_a_form()・add_afs_ace()・add_failed_connection_entry()・add_name_to_subnet()・add_trusted_domain()・ads_check_posix_schema_mapping()・ads_cleanup_expired_creds()・ads_dc_name()・ads_do_paged_search_args()・ads_generate_service_principal()・ads_get_gpo_list()・ads_gpo_prepare_local_store()・ads_init()・ads_keytab_add_entry()・ads_keytab_verify_ticket()・ads_ou_string()・ads_site_dn_for_machine()・ads_sitename_match()・afs_set_nt_acl()・announce_server()・api_pipe_bind_req()・api_RNetServerEnum()・api_RNetServerGetInfo()・api_SamOEMChangePassword()・assume_domain()・assume_own_realm()・call_trans2qfilepathinfo()・call_trans2qfsinfo()・canonicalize_ea_name()・cgi_load_variables()・cgi_waspost()・check_bind_req()・check_bind_response()・check_domain_match()・check_for_master_browser_fail()・check_magic()・check_master_browser_exists()・check_negative_conn_cache_timeout()・check_ntdomain_security()・check_samstrict_security()・check_share_sanity()・check_trustdomain_security()・check_winbind_security()・child_msg_offline()・child_msg_online()・cli_check_msdfs_proxy()・cli_cm_find()・cli_cm_get_mntpoint()・cli_cm_set_mntpoint()・cli_ns_check_server_type()・cli_resolve_path()・cli_session_setup_spnego()・cmd_help()・cmd_print()・cmd_seal()・cmd_sign()・cmd_spoolss_deletedriverex()・cmd_spoolss_enum_drivers()・cmd_spoolss_setprinterdata()・copy_fn()・copy_id21_to_sam_passwd()・count_fn()・create_local_private_krb5_conf_for_domain()・create_workgroup()・delete_printer_key()・display_finfo()・do_cd()・do_command()・do_list_helper()・do_mget()・dptr_closepath()・driver_arch_fetch_values()・drv_file_in_use()・ea_list_union()・elog_open()・elog_open_tdb()・elog_validate_logname()・enum_dom_groups()・equal_parameter()・eventlog_add_source()・expect()・fcb_or_dos_open()・fetch_domain_info()・fetch_reg_values_specific()・fill_service_values()・fill_share_info()・fill_svc_config()・fillup_pw_field()・find_browser_in_lmb_cache()・find_domain_from_name_noinit()・find_idmap_domain_from_sid()・find_lookup_domain_from_name()・find_memory_creds_by_name()・find_nss_domain()・find_server_in_workgroup()・find_service()・find_service_by_name()・find_valuename_index()・find_workgroup_on_subnet()・flush_negative_conn_cache_for_domain()・fname_equal()・generate_krb5_ccache()・get_a_builtin_ntform()・get_alloc_methods()・get_audit_category_from_param()・get_ccache_by_username()・get_common_service_dispname()・get_dc_list()・get_dc_name()・get_dcs()・get_group_map_from_ntname()・get_lanman2_dir_entry()・get_longvar_val()・get_methods()・get_print_db_byname()・get_printer_subkeys()・get_privilege_dispname()・get_sec_channel_type()・get_server_info()・get_share_type()・gpo_process_a_gpo()・gpo_sync_func()・grant_privilege_by_name()・guid_string_to_name()・idmap_ad_initialize()・idmap_init()・init_bitmap()・init_pipe_handle_list()・init_srv_sess_info_1()・initiate_myworkgroup_startup()・internal_resolve_name()・interpret_protocol()・is_default()・is_executable()・is_myname()・is_myname_or_ipaddr()・is_myworkgroup()・is_our_machine_account()・is_our_primary_domain()・is_owner()・is_trusted_domain_situation()・key_driver_fetch_keys()・key_printers_fetch_keys()・ldapsam_delete_entry()・list_match()・load_usershare_service()・lookup_builtin_name()・lookup_global_sam_name()・lookup_name()・lookup_printerkey()・lookup_wellknown_name()・lp_add_home()・lp_enum()・lp_set_enum_parm()・main()・make_connection()・make_connection_snum()・make_pw_chat()・make_user_info_map()・manage_ntlm_change_password_1_request()・manage_ntlm_server_1_request()・mangled_equal()・map_filename()・map_to_os2_driver()・map_username()・matchname()・move_driver_to_download_area()・msg_failed_to_go_online()・msg_force_tdis()・msg_try_to_go_online()・name_to_guid_string()・named_pipe()・net_ads_join()・net_copy_driverfile()・net_idmap_secret()・net_lookup_dc()・net_rap_server()・net_sam_do_list()・net_sam_policy_set()・net_sam_set_pwdmustchangenow()・net_sam_set_userflag()・net_sh_process()・net_status_sessions()・net_status_shares()・nmb_name_equal()・nmbd_message_election()・nss_get_backend()・nt_open_pipe()・only_ipaddrs_in_list()・parse_dest()・parse_dfs_path()・parse_gpttmpl()・parse_lpq_aix()・parse_lpq_bsd()・parse_lpq_hpux()・parse_lpq_lprng()・parse_lpq_nt()・parse_lpq_os2()・parse_lpq_plp()・parse_lpq_qnx()・parse_lpq_sysv()・pcap_cache_reload()・pcap_printername_ok()・pjob_store_notify()・popt_common_credentials_callback()・print_domain_groups()・print_domain_users()・print_notify_send_messages_to_printer()・printer_driver_files_in_use()・printer_driver_in_use()・process_announce_request()・process_browse_packet()・process_cmd()・process_dgram()・process_election()・process_get_backup_list_request()・process_host_announce()・process_lanman_packet()・process_lm_announce_request()・process_lm_host_announce()・process_name_release_request()・process_node_status_request()・process_tok()・process_workgroup_announce()・py_smb_tconx()・receive_getdc_response()・reg_split_hive()・register_name_response()・regsubkey_ctr_delkey()・regsubkey_ctr_key_exists()・regval_ctr_delvalue()・regval_ctr_getvalue()・regval_ctr_key_exists()・rename_internals()・rename_internals_fsp()・reply_copy()・reply_negprot()・reply_open_pipe_and_X()・reply_spnego_kerberos()・resolve_lmhosts()・revoke_privilege_by_name()・rpc_audit_set_internal()・rpc_auth_verifier_chk()・rpc_group_list_internals()・rpc_printer_migrate_settings_internals()・rpc_rights_list_internal()・rpc_sh_user_flag_edit_internals()・rpc_share_migrate_files_internals()・run_test()・sam_account_from_delta()・sam_account_ok()・samba_private_attr_name()・samu_set_unix_internal()・se_priv_from_name()・SearchDir()・send_notify2_changes()・send_spoolss_notify2_msg()・server_cryptkey()・set_local_machine_name()・set_netbios_aliases()・set_printer_hnd_name()・set_socket_options()・set_user_info_21()・set_workgroup_local_master_browser_name()・setup_return_cc_name()・share_sanity_checks()・smb_delete_user()・smb_ldap_setup_conn()・smb_pam_start()・smbc_getatr()・smbldap_check_root_dse()・smbldap_set_mod()・snapin_guid_string_to_name()・stored_sitename_changed()・string_match()・talktochild()・test_one()・trustdom_recv()・unix_wild_match()・unlink_internals()・unpack_values()・update_printer()・user_in_list()・validate_group()・wbinfo_domain_info()・wbinfo_lookuprids()・winbindd_dual_list_trusted_domains()・winbindd_dual_pam_auth_cached()・winbindd_getgrnam()・winbindd_getpwnam()・winbindd_list_groups()・winbindd_list_users()・winbindd_setpwent_internal()・wins_process_name_query_request()・write_this_workgroup_name()・writetarheader().

{
        if (s1 == s2)
                return(True);
        if (!s1 || !s2)
                return(False);
  
        return(StrCaseCmp(s1,s2)==0);
}

BOOL strnequal	(	const char *	s1,
		const char *	s2,
		size_t	n
	)

Compare 2 strings up to and including the nth char.

覚え書き:

The comparison is case-insensitive.

util_str.c の 298 行で定義されています。

参照先 StrnCaseCmp().

参照元 ads_add_gpo_link()・ads_get_gpo()・ads_pull_strings_range()・cgi_handle_authorization()・cgi_setup()・cgi_setup_error()・check_name_to_ntstatus_security()・get_ea_list_from_file()・get_ea_value()・handle_trans()・is_msdfs_link()・is_reserved_name()・net_ads_gpo_get_gpo()・net_usershare_add()・parse_quota_set()・process_tok()・send_backup_list_response()・smb_ldap_setup_conn()・startsmbfilepwent()・strhex_to_str().

{
        if (s1 == s2)
                return(True);
        if (!s1 || !s2 || !n)
                return(False);
  
        return(StrnCaseCmp(s1,s2,n)==0);
}

BOOL strcsequal	(	const char *	s1,
		const char *	s2
	)

Compare 2 strings (case sensitive).

util_str.c の 312 行で定義されています。

参照元 api_NetWkstaGetInfo()・api_RDosPrintJobDel()・api_WPrintQueueCtrl()・ccache_entry_identical()・cli_list_new()・reload_nmbd_services()・reload_services()・reload_services_file()・rename_internals()・rename_internals_fsp()・reply_negprot()・str_list_compare()・vfs_ChDir().

{
        if (s1 == s2)
                return(True);
        if (!s1 || !s2)
                return(False);
  
        return(strcmp(s1,s2)==0);
}

int strwicmp	(	const char *	psz1,
		const char *	psz2
	)

Do a case-insensitive, whitespace-ignoring string compare.

util_str.c の 326 行で定義されています。

参照先 toupper_ascii().

参照元 conv_str_size()・do_section()・dump_a_parameter()・get_credentials_file()・main()・map_parameter()・read_credentials_file()・service_ok()・set_boolean().

{
        /* if BOTH strings are NULL, return TRUE, if ONE is NULL return */
        /* appropriate value. */
        if (psz1 == psz2)
                return (0);
        else if (psz1 == NULL)
                return (-1);
        else if (psz2 == NULL)
                return (1);

        /* sync the strings on first non-whitespace */
        while (1) {
                while (isspace((int)*psz1))
                        psz1++;
                while (isspace((int)*psz2))
                        psz2++;
                if (toupper_ascii(*psz1) != toupper_ascii(*psz2) || *psz1 == '\0'
                    || *psz2 == '\0')
                        break;
                psz1++;
                psz2++;
        }
        return (*psz1 - *psz2);
}

char* strupper_static

(

const char *

s

)

Convert a string to upper case, but don't modify it.

util_str.c の 357 行で定義されています。

参照先 strupper_m().

参照元 namecache_key()・namecache_status_record_key()・saf_key()・sitename_key()・trustdom_cache_key().

{
        static pstring str;

        pstrcpy(str, s);
        strupper_m(str);

        return str;
}

void strnorm	(	char *	s,
		int	case_default
	)

Convert a string to "normal" form.

util_str.c の 371 行で定義されています。

参照先 CASE_UPPER・strlower_m()・strupper_m().

参照元 prealloc_open()・unix_convert().

{
        if (case_default == CASE_UPPER)
                strupper_m(s);
        else
                strlower_m(s);
}

BOOL strisnormal	(	const char *	s,
		int	case_default
	)

Check if a string is in "normal" case.

util_str.c の 383 行で定義されています。

参照先 CASE_UPPER・strhaslower()・strhasupper().

参照元 to_8_3().

{
        if (case_default == CASE_UPPER)
                return(!strhaslower(s));
        
        return(!strhasupper(s));
}

void string_replace	(	char *	s,
		char	oldc,
		char	newc
	)

String replace.

NOTE: oldc and newc must be 7 bit characters

util_str.c の 401 行で定義されています。

参照先 next_codepoint().

参照元 _srv_net_share_add()・_srv_net_share_set_info()・api_RNetShareAdd()・call_trans2qfilepathinfo()・dfs_path_lookup()・enum_file_fn()・init_mount()・init_srv_share_info_2()・init_srv_share_info_502()・main()・notify_fsp()・parse_mount_smb()・parse_msdfs_symlink()・writetarheader().

{
        char *p;

        /* this is quite a common operation, so we want it to be
           fast. We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars) */

        for (p = s; *p; p++) {
                if (*p & 0x80) /* mb string - slow path. */
                        break;
                if (*p == oldc) {
                        *p = newc;
                }
        }

        if (!*p)
                return;

        /* Slow (mb) path. */
#ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
        /* With compose characters we must restart from the beginning. JRA. */
        p = s;
#endif

        while (*p) {
                size_t c_size;
                next_codepoint(p, &c_size);

                if (c_size == 1) {
                        if (*p == oldc) {
                                *p = newc;
                        }
                }
                p += c_size;
        }
}

char* push_skip_string

(

char *

buf

)

Skip past some strings in a buffer - old version - no checks.

util_str.c の 444 行で定義されています。

{
        buf += strlen(buf) + 1;
        return(buf);
}

char* skip_string	(	const char *	base,
		size_t	len,
		char *	buf
	)

Skip past a string in a buffer.

Buffer may not be null terminated. end_ptr points to the first byte after then end of the buffer.

util_str.c の 456 行で定義されています。

参照元 announce_local_master_browser_to_domain_master_browser()・api_DosPrintQEnum()・api_DosPrintQGetInfo()・api_NetUserGetGroups()・api_NetWkstaGetInfo()・api_PrintJobInfo()・api_RDosPrintJobDel()・api_reply()・api_RNetGroupEnum()・api_RNetGroupGetUsers()・api_RNetServerEnum()・api_RNetServerGetInfo()・api_RNetSessionEnum()・api_RNetShareAdd()・api_RNetShareEnum()・api_RNetShareGetInfo()・api_RNetUserEnum()・api_RNetUserGetInfo()・api_SamOEMChangePassword()・api_SetUserPassword()・api_WAccessGetUserPerms()・api_WPrintDestEnum()・api_WPrintDestGetInfo()・api_WPrintDriverEnum()・api_WPrintJobEnumerate()・api_WPrintJobGetInfo()・api_WPrintPortEnum()・api_WPrintQProcEnum()・api_WPrintQueueCtrl()・api_WWkstaUserLogon()・browse_sync_remote()・cli_NetServerEnum()・cli_NetWkstaUserLogon()・cli_oem_change_password()・cli_print_queue()・cli_printjob_del()・cli_RNetShareEnum()・cli_send_mailslot()・get_safe_str_ptr()・process_lm_host_announce()・process_logon_packet()・send_backup_list_response()・send_election_dgram()・send_mailslot().

{
        const char *end_ptr = base + len;

        if (end_ptr < base || !base || !buf || buf >= end_ptr) {
                return NULL;
        }

        /* Skip the string */
        while (*buf) {
                buf++;
                if (buf >= end_ptr) {
                        return NULL;
                }
        }
        /* Skip the '\0' */
        buf++;
        return buf;
}

size_t str_charnum

(

const char *

s

)

Count the number of characters in a string.

Normally this will be the same as the number of bytes in a string for single byte strings, but will be different for multibyte.

util_str.c の 482 行で定義されています。

参照先 push_ucs2()・strlen_w().

参照元 change_oem_password()・msrpc_gen().

{
        uint16 tmpbuf2[sizeof(pstring)];
        push_ucs2(NULL, tmpbuf2,s, sizeof(tmpbuf2), STR_TERMINATE);
        return strlen_w(tmpbuf2);
}

size_t str_ascii_charnum

(

const char *

s

)

Count the number of characters in a string.

Normally this will be the same as the number of bytes in a string for single byte strings, but will be different for multibyte.

util_str.c の 495 行で定義されています。

参照先 push_ascii().

参照元 msrpc_gen().

{
        pstring tmpbuf2;
        push_ascii(tmpbuf2, s, sizeof(tmpbuf2), STR_TERMINATE);
        return strlen(tmpbuf2);
}

BOOL trim_char	(	char *	s,
		char	cfront,
		char	cback
	)

util_str.c の 502 行で定義されています。

参照先 fp・trim_string().

参照元 _dfs_Remove()・cli_chkpath()・cmd_mkdir()・create_msdfs_link()・dfs_path_lookup()・domain_master_node_status_success()・expect()・get_domain_master_name_node_status_success()・init_names()・init_reply_dfs_info_3()・load_auth_module()・load_msg()・lock_path()・lp_do_parameter()・lp_string()・make_pdb_method_name()・make_pw_chat()・net_sam_provision()・parse_dfs_path()・parse_lpq_nt()・parse_lpq_os2()・parse_node_status()・parse_usershare_file()・pdb_init_ldapsam()・pdb_init_ldapsam_compat()・pid_path()・recycle_unlink()・set_local_machine_name()・set_remote_machine_name()・smb_pam_passchange_conv()・sub_set_smb_name()・update_a_printer_2()・uw_pathname()・vfs_init_custom()・write_browse_list().

{
        BOOL ret = False;
        char *ep;
        char *fp = s;

        /* Ignore null or empty strings. */
        if (!s || (s[0] == '\0'))
                return False;

        if (cfront) {
                while (*fp && *fp == cfront)
                        fp++;
                if (!*fp) {
                        /* We ate the string. */
                        s[0] = '\0';
                        return True;
                }
                if (fp != s)
                        ret = True;
        }

        ep = fp + strlen(fp) - 1;
        if (cback) {
                /* Attempt ascii only. Bail for mb strings. */
                while ((ep >= fp) && (*ep == cback)) {
                        ret = True;
                        if ((ep > fp) && (((unsigned char)ep[-1]) & 0x80)) {
                                /* Could be mb... bail back to tim_string. */
                                char fs[2], bs[2];
                                if (cfront) {
                                        fs[0] = cfront;
                                        fs[1] = '\0';
                                }
                                bs[0] = cback;
                                bs[1] = '\0';
                                return trim_string(s, cfront ? fs : NULL, bs);
                        } else {
                                ep--;
                        }
                }
                if (ep < fp) {
                        /* We ate the string. */
                        s[0] = '\0';
                        return True;
                }
        }

        ep[1] = '\0';
        memmove(s, fp, ep-fp+2);
        return ret;
}

BOOL trim_string	(	char *	s,
		const char *	front,
		const char *	back
	)

Trim the specified elements off the front and back of a string.

util_str.c の 559 行で定義されています。

参照先 len.

参照元 cmd_mput()・dos_clean_name()・driver_unix_convert()・fill_printq_info_52()・parse_usershare_file()・seek_list()・smbc_getatr()・trim_char()・unix_clean_name()・update_a_printer_2().

{
        BOOL ret = False;
        size_t front_len;
        size_t back_len;
        size_t len;

        /* Ignore null or empty strings. */
        if (!s || (s[0] == '\0'))
                return False;

        front_len       = front? strlen(front) : 0;
        back_len        = back? strlen(back) : 0;

        len = strlen(s);

        if (front_len) {
                while (len && strncmp(s, front, front_len)==0) {
                        /* Must use memmove here as src & dest can
                         * easily overlap. Found by valgrind. JRA. */
                        memmove(s, s+front_len, (len-front_len)+1);
                        len -= front_len;
                        ret=True;
                }
        }
        
        if (back_len) {
                while ((len >= back_len) && strncmp(s+len-back_len,back,back_len)==0) {
                        s[len-back_len]='\0';
                        len -= back_len;
                        ret=True;
                }
        }
        return ret;
}

BOOL strhasupper

(

const char *

s

)

Does a string have any uppercase chars in it?

util_str.c の 599 行で定義されています。

参照先 isupper_w()・push_ucs2()・tmpbuf.

参照元 pass_check()・strisnormal().

{
        smb_ucs2_t *ptr;
        push_ucs2(NULL, tmpbuf,s, sizeof(tmpbuf), STR_TERMINATE);
        for(ptr=tmpbuf;*ptr;ptr++)
                if(isupper_w(*ptr))
                        return True;
        return(False);
}

BOOL strhaslower

(

const char *

s

)

Does a string have any lowercase chars in it?

util_str.c の 613 行で定義されています。

参照先 islower_w()・push_ucs2()・tmpbuf.

参照元 pass_check()・strisnormal().

{
        smb_ucs2_t *ptr;
        push_ucs2(NULL, tmpbuf,s, sizeof(tmpbuf), STR_TERMINATE);
        for(ptr=tmpbuf;*ptr;ptr++)
                if(islower_w(*ptr))
                        return True;
        return(False);
}

size_t count_chars	(	const char *	s,
		char	c
	)

Find the number of 'c' chars in a string

util_str.c の 627 行で定義されています。

参照先 push_ucs2_allocate().

参照元 ipstr_list_parse()・main()・net_usershare_add()・notify_add()・parse_acl_string()・parse_usershare_acl().

{
        smb_ucs2_t *ptr;
        int count;
        smb_ucs2_t *alloc_tmpbuf = NULL;

        if (push_ucs2_allocate(&alloc_tmpbuf, s) == (size_t)-1) {
                return 0;
        }

        for(count=0,ptr=alloc_tmpbuf;*ptr;ptr++)
                if(*ptr==UCS2_CHAR(c))
                        count++;

        SAFE_FREE(alloc_tmpbuf);
        return(count);
}

char* safe_strcpy_fn	(	const char *	fn,
		int	line,
		char *	dest,
		const char *	src,
		size_t	maxlength
	)

Safe string copy into a known length string.

maxlength does not include the terminating zero.

util_str.c の 650 行で定義されています。

参照先 clobber_region()・len.

{
        size_t len;

        if (!dest) {
                DEBUG(0,("ERROR: NULL dest in safe_strcpy, called from [%s][%d]\n", fn, line));
                return NULL;
        }

#ifdef DEVELOPER
        clobber_region(fn,line,dest, maxlength+1);
#endif

        if (!src) {
                *dest = 0;
                return dest;
        }  

        len = strnlen(src, maxlength+1);

        if (len > maxlength) {
                DEBUG(0,("ERROR: string overflow by %lu (%lu - %lu) in safe_strcpy [%.50s]\n",
                         (unsigned long)(len-maxlength), (unsigned long)len, 
                         (unsigned long)maxlength, src));
                len = maxlength;
        }
      
        memmove(dest, src, len);
        dest[len] = 0;
        return dest;
}  

char* safe_strcat_fn	(	const char *	fn,
		int	line,
		char *	dest,
		const char *	src,
		size_t	maxlength
	)

Safe string cat into a string.

maxlength does not include the terminating zero.

util_str.c の 686 行で定義されています。

参照先 clobber_region().

{
        size_t src_len, dest_len;

        if (!dest) {
                DEBUG(0,("ERROR: NULL dest in safe_strcat, called from [%s][%d]\n", fn, line));
                return NULL;
        }

        if (!src)
                return dest;
        
        src_len = strnlen(src, maxlength + 1);
        dest_len = strnlen(dest, maxlength + 1);

#ifdef DEVELOPER
        clobber_region(fn, line, dest + dest_len, maxlength + 1 - dest_len);
#endif

        if (src_len + dest_len > maxlength) {
                DEBUG(0,("ERROR: string overflow by %d in safe_strcat [%.50s]\n",
                         (int)(src_len + dest_len - maxlength), src));
                if (maxlength > dest_len) {
                        memcpy(&dest[dest_len], src, maxlength - dest_len);
                }
                dest[maxlength] = 0;
                return NULL;
        }

        memcpy(&dest[dest_len], src, src_len);
        dest[dest_len + src_len] = 0;
        return dest;
}

char* alpha_strcpy_fn	(	const char *	fn,
		int	line,
		char *	dest,
		const char *	src,
		const char *	other_safe_chars,
		size_t	maxlength
	)

Paranoid strcpy into a buffer of given length (includes terminating zero.

Strips out all but 'a-Z0-9' and the character in other_safe_chars and replaces with '_'. Deliberately does *NOT* check for multibyte characters. Don't change it !

util_str.c の 726 行で定義されています。

参照先 clobber_region()・islower_ascii()・isupper_ascii()・len・strchr_m().

{
        size_t len, i;

#ifdef DEVELOPER
        clobber_region(fn, line, dest, maxlength);
#endif

        if (!dest) {
                DEBUG(0,("ERROR: NULL dest in alpha_strcpy, called from [%s][%d]\n", fn, line));
                return NULL;
        }

        if (!src) {
                *dest = 0;
                return dest;
        }  

        len = strlen(src);
        if (len >= maxlength)
                len = maxlength - 1;

        if (!other_safe_chars)
                other_safe_chars = "";

        for(i = 0; i < len; i++) {
                int val = (src[i] & 0xff);
                if (isupper_ascii(val) || islower_ascii(val) || isdigit(val) || strchr_m(other_safe_chars, val))
                        dest[i] = src[i];
                else
                        dest[i] = '_';
        }

        dest[i] = '\0';

        return dest;
}

char* StrnCpy_fn	(	const char *	fn,
		int	line,
		char *	dest,
		const char *	src,
		size_t	n
	)

Like strncpy but always null terminates.

Make sure there is room! The variable n should always be one less than the available size.

util_str.c の 768 行で定義されています。

参照先 clobber_region().

{
        char *d = dest;

#ifdef DEVELOPER
        clobber_region(fn, line, dest, n+1);
#endif

        if (!dest) {
                DEBUG(0,("ERROR: NULL dest in StrnCpy, called from [%s][%d]\n", fn, line));
                return(NULL);
        }

        if (!src) {
                *dest = 0;
                return(dest);
        }
        
        while (n-- && (*d = *src)) {
                d++;
                src++;
        }

        *d = 0;
        return(dest);
}

static char* strncpyn	(	char *	dest,
		const char *	src,
		size_t	n,
		char	c
	)			[static]

Like strncpy but copies up to the character marker.

always null terminates. returns a pointer to the character marker in the source string (src).

util_str.c の 801 行で定義されています。

参照先 clobber_region()・strchr_m().

{
        char *p;
        size_t str_len;

#ifdef DEVELOPER
        clobber_region(dest, n+1);
#endif
        p = strchr_m(src, c);
        if (p == NULL) {
                DEBUG(5, ("strncpyn: separator character (%c) not found\n", c));
                return NULL;
        }

        str_len = PTR_DIFF(p, src);
        strncpy(dest, src, MIN(n, str_len));
        dest[str_len] = '\0';

        return p;
}

size_t strhex_to_str	(	char *	p,
		size_t	len,
		const char *	strhex
	)

Routine to get hex characters and turn them into a 16 byte array.

the array can be variable length, and any non-hex-numeric characters are skipped. "0xnn" or "0Xnn" is specially catered for.

valid examples: "0A5D15"; "0x15, 0x49, 0xa2"; "59\ta9\te3\n"

util_str.c の 833 行で定義されています。

参照先 strchr_m()・strnequal()・toupper_ascii().

参照元 ads_get_sid_from_extended_dn()・init_rpc_blob_hex()・strhex_to_data_blob().

{
        size_t i;
        size_t num_chars = 0;
        unsigned char   lonybble, hinybble;
        const char     *hexchars = "0123456789ABCDEF";
        char           *p1 = NULL, *p2 = NULL;

        for (i = 0; i < len && strhex[i] != 0; i++) {
                if (strnequal(hexchars, "0x", 2)) {
                        i++; /* skip two chars */
                        continue;
                }

                if (!(p1 = strchr_m(hexchars, toupper_ascii(strhex[i]))))
                        break;

                i++; /* next hex digit */

                if (!(p2 = strchr_m(hexchars, toupper_ascii(strhex[i]))))
                        break;

                /* get the two nybbles */
                hinybble = PTR_DIFF(p1, hexchars);
                lonybble = PTR_DIFF(p2, hexchars);

                p[num_chars] = (hinybble << 4) | lonybble;
                num_chars++;

                p1 = NULL;
                p2 = NULL;
        }
        return num_chars;
}

DATA_BLOB strhex_to_data_blob	(	TALLOC_CTX *	mem_ctx,
		const char *	strhex
	)

util_str.c の 868 行で定義されています。

参照先 data_blob_::data・data_blob()・data_blob_talloc()・data_blob_::length・strhex_to_str().

参照元 cmd_spoolss_setprinterdata()・main()・manage_ntlm_change_password_1_request()・manage_ntlm_server_1_request().

{
        DATA_BLOB ret_blob;

        if (mem_ctx != NULL)
                ret_blob = data_blob_talloc(mem_ctx, NULL, strlen(strhex)/2+1);
        else
                ret_blob = data_blob(NULL, strlen(strhex)/2+1);

        ret_blob.length = strhex_to_str((char*)ret_blob.data,   
                                        strlen(strhex), 
                                        strhex);

        return ret_blob;
}

char* hex_encode	(	TALLOC_CTX *	mem_ctx,
		const unsigned char *	buff_in,
		size_t	len
	)

Routine to print a buffer as HEX digits, into an allocated string.

util_str.c の 888 行で定義されています。

参照元 check_auth_crap()・display_reg_value()・manage_ntlm_server_1_request().

{
        int i;
        char *hex_buffer;

        hex_buffer = TALLOC_ARRAY(mem_ctx, char, (len*2)+1);

        for (i = 0; i < len; i++)
                slprintf(&hex_buffer[i*2], 3, "%02X", buff_in[i]);

        return hex_buffer;
}

BOOL in_list	(	const char *	s,
		const char *	list,
		BOOL	casesensitive
	)

Check if a string is part of a list.

util_str.c の 905 行で定義されています。

参照先 next_token()・StrCaseCmp().

参照元 add_session_user()・call_trans2findfirst()・call_trans2findnext()・check_share_sanity()・ntlmssp_want_feature_list()・reply_search().

{
        pstring tok;
        const char *p=list;

        if (!list)
                return(False);

        while (next_token(&p,tok,LIST_SEP,sizeof(tok))) {
                if (casesensitive) {
                        if (strcmp(tok,s) == 0)
                                return(True);
                } else {
                        if (StrCaseCmp(tok,s) == 0)
                                return(True);
                }
        }
        return(False);
}

static BOOL string_init	(	char **	dest,
		const char *	src
	)			[static]

Set a string value, allocing the space for the string

util_str.c の 932 行で定義されています。

参照先 null_string.

参照元 string_set().

{
        size_t l;

        if (!src)     
                src = "";

        l = strlen(src);

        if (l == 0) {
                *dest = CONST_DISCARD(char*, null_string);
        } else {
                (*dest) = SMB_STRDUP(src);
                if ((*dest) == NULL) {
                        DEBUG(0,("Out of memory in string_init\n"));
                        return False;
                }
        }
        return(True);
}

void string_free

(

char **

s

)

Free a string value.

util_str.c の 957 行で定義されています。

参照先 null_string.

参照元 add_a_service()・conn_free_internal()・copy_service()・file_free()・FN_LOCAL_PARM_BOOL()・free_service()・init_globals()・lp_do_parameter()・print_fsp_end()・string_set().

{
        if (!s || !(*s))
                return;
        if (*s == null_string)
                *s = NULL;
        SAFE_FREE(*s);
}

BOOL string_set	(	char **	dest,
		const char *	src
	)

Set a string value, deallocating any existing space, and allocing the space for the string

util_str.c の 971 行で定義されています。

参照先 string_free()・string_init().

参照元 add_a_service()・call_trans2findnext()・conn_new()・copy_service()・dptr_close_internal()・dptr_create()・dup_file_fsp()・file_new()・handle_charset()・handle_copy()・handle_debug_list()・handle_idmap_gid()・handle_idmap_uid()・handle_include()・handle_netbios_name()・handle_netbios_scope()・handle_workgroup()・init_globals()・init_printer_values()・lp_add_home()・lp_add_ipc()・lp_add_one_printer()・lp_add_printer()・lp_do_parameter()・main()・make_connection_snum()・msg_file_was_renamed()・open_directory()・open_fake_file()・open_file()・open_file_stat()・print_fsp_open()・process_usershare_file()・rename_open_files()・reply_search()・set_conn_connectpath()・vfs_GetWd().

{
        string_free(dest);
        return(string_init(dest,src));
}

void string_sub2	(	char *	s,
		const char *	pattern,
		const char *	insert,
		size_t	len,
		BOOL	remove_unsafe_characters,
		BOOL	replace_once,
		BOOL	allow_trailing_dollar
	)

Substitute a string for a pattern in another string.

Make sure there is enough room!

This routine looks for pattern in s and replaces it with insert. It may do multiple replacements or just one.

Any of " ; ' $ or ` in the insert string are replaced with _ if len==0 then the string cannot be extended. This is different from the old use of len==0 which was for no length checks to be done.

util_str.c の 989 行で定義されています。

参照先 strstr_m().

参照元 ldapsam_rename_sam_account()・print_queue_update()・string_sub()・string_sub_once()・tdbsam_rename_sam_account().

{
        char *p;
        ssize_t ls,lp,li, i;

        if (!insert || !pattern || !*pattern || !s)
                return;

        ls = (ssize_t)strlen(s);
        lp = (ssize_t)strlen(pattern);
        li = (ssize_t)strlen(insert);

        if (len == 0)
                len = ls + 1; /* len is number of *bytes* */

        while (lp <= ls && (p = strstr_m(s,pattern))) {
                if (ls + (li-lp) >= len) {
                        DEBUG(0,("ERROR: string overflow by %d in string_sub(%.50s, %d)\n", 
                                 (int)(ls + (li-lp) - len),
                                 pattern, (int)len));
                        break;
                }
                if (li != lp) {
                        memmove(p+li,p+lp,strlen(p+lp)+1);
                }
                for (i=0;i<li;i++) {
                        switch (insert[i]) {
                        case '`':
                        case '"':
                        case '\'':
                        case ';':
                        case '$':
                                /* allow a trailing $ (as in machine accounts) */
                                if (allow_trailing_dollar && (i == li - 1 )) {
                                        p[i] = insert[i];
                                        break;
                                }
                        case '%':
                        case '\r':
                        case '\n':
                                if ( remove_unsafe_characters ) {
                                        p[i] = '_';
                                        /* yes this break should be here since we want to 
                                           fall throw if not replacing unsafe chars */
                                        break;
                                }
                        default:
                                p[i] = insert[i];
                        }
                }
                s = p + li;
                ls += (li-lp);

                if (replace_once)
                        break;
        }
}

void string_sub_once	(	char *	s,
		const char *	pattern,
		const char *	insert,
		size_t	len
	)

util_str.c の 1048 行で定義されています。

参照先 string_sub2().

{
        string_sub2( s, pattern, insert, len, True, True, False );
}

void string_sub	(	char *	s,
		const char *	pattern,
		const char *	insert,
		size_t	len
	)

util_str.c の 1053 行で定義されています。

参照先 string_sub2().

参照元 cgi_setup()・fstring_sub()・parse_lpq_aix()・parse_lpq_hpux()・parse_lpq_plp()・parse_lpq_qnx()・pstring_sub()・reghook_cache_find().

{
        string_sub2( s, pattern, insert, len, True, False, False );
}

void fstring_sub	(	char *	s,
		const char *	pattern,
		const char *	insert
	)

util_str.c の 1058 行で定義されています。

参照先 string_sub().

参照元 pwd_sub().

{
        string_sub(s, pattern, insert, sizeof(fstring));
}

void pstring_sub	(	char *	s,
		const char *	pattern,
		const char *	insert
	)

util_str.c の 1063 行で定義されています。

参照先 string_sub().

参照元 _Insure_trap_error()・ads_gpo_explode_filesyspath()・afs_login()・authorise_login()・automount_lookup()・chgpasswd()・CopyExpanded()・create_conn_struct()・Expand()・generic_job_submit()・msg_deliver()・normalize_reg_path()・print_run_command()・regdb_fetch_keys()・reghook_cache_add()・smb_add_user_group()・smb_create_group()・smb_delete_group()・smb_delete_user_group()・StrlenExpanded()・try_open().

{
        string_sub(s, pattern, insert, sizeof(pstring));
}

char* realloc_string_sub	(	char *	string,
		const char *	pattern,
		const char *	insert
	)

Similar to string_sub, but it will accept only allocated strings and may realloc them so pay attention at what you pass on no pointers inside strings, no pstrings or const may be passed as string.

util_str.c の 1075 行で定義されています。

参照先 strstr_m().

参照元 alloc_sub_advanced()・alloc_sub_basic()・realloc_expand_env_var()・realloc_expand_longvar().

{
        char *p, *in;
        char *s;
        ssize_t ls,lp,li,ld, i;

        if (!insert || !pattern || !*pattern || !string || !*string)
                return NULL;

        s = string;

        in = SMB_STRDUP(insert);
        if (!in) {
                DEBUG(0, ("realloc_string_sub: out of memory!\n"));
                return NULL;
        }
        ls = (ssize_t)strlen(s);
        lp = (ssize_t)strlen(pattern);
        li = (ssize_t)strlen(insert);
        ld = li - lp;
        for (i=0;i<li;i++) {
                switch (in[i]) {
                        case '`':
                        case '"':
                        case '\'':
                        case ';':
                        case '$':
                        case '%':
                        case '\r':
                        case '\n':
                                in[i] = '_';
                        default:
                                /* ok */
                                break;
                }
        }
        
        while ((p = strstr_m(s,pattern))) {
                if (ld > 0) {
                        int offset = PTR_DIFF(s,string);
                        string = (char *)SMB_REALLOC(string, ls + ld + 1);
                        if (!string) {
                                DEBUG(0, ("realloc_string_sub: out of memory!\n"));
                                SAFE_FREE(in);
                                return NULL;
                        }
                        p = string + offset + (p - s);
                }
                if (li != lp) {
                        memmove(p+li,p+lp,strlen(p+lp)+1);
                }
                memcpy(p, in, li);
                s = p + li;
                ls += ld;
        }
        SAFE_FREE(in);
        return string;
}

char* talloc_string_sub	(	TALLOC_CTX *	mem_ctx,
		const char *	src,
		const char *	pattern,
		const char *	insert
	)

util_str.c の 1137 行で定義されています。

参照先 string・strstr_m()・talloc_strdup().

参照元 find_forced_group()・find_forced_user()・get_ldap_filter()・log_nt_token()・talloc_sub_specified()・token_contains_name()・winbindd_dual_pam_auth().

{
        char *p, *in;
        char *s;
        char *string;
        ssize_t ls,lp,li,ld, i;

        if (!insert || !pattern || !*pattern || !src || !*src)
                return NULL;

        string = talloc_strdup(mem_ctx, src);
        if (string == NULL) {
                DEBUG(0, ("talloc_strdup failed\n"));
                return NULL;
        }

        s = string;

        in = SMB_STRDUP(insert);
        if (!in) {
                DEBUG(0, ("talloc_string_sub: out of memory!\n"));
                return NULL;
        }
        ls = (ssize_t)strlen(s);
        lp = (ssize_t)strlen(pattern);
        li = (ssize_t)strlen(insert);
        ld = li - lp;
        for (i=0;i<li;i++) {
                switch (in[i]) {
                        case '`':
                        case '"':
                        case '\'':
                        case ';':
                        case '$':
                        case '%':
                        case '\r':
                        case '\n':
                                in[i] = '_';
                        default:
                                /* ok */
                                break;
                }
        }
        
        while ((p = strstr_m(s,pattern))) {
                if (ld > 0) {
                        int offset = PTR_DIFF(s,string);
                        string = (char *)TALLOC_REALLOC(mem_ctx, string,
                                                        ls + ld + 1);
                        if (!string) {
                                DEBUG(0, ("talloc_string_sub: out of "
                                          "memory!\n"));
                                SAFE_FREE(in);
                                return NULL;
                        }
                        p = string + offset + (p - s);
                }
                if (li != lp) {
                        memmove(p+li,p+lp,strlen(p+lp)+1);
                }
                memcpy(p, in, li);
                s = p + li;
                ls += ld;
        }
        SAFE_FREE(in);
        return string;
}

void all_string_sub	(	char *	s,
		const char *	pattern,
		const char *	insert,
		size_t	len
	)

Similar to string_sub() but allows for any character to be substituted.

Use with caution! if len==0 then the string cannot be extended. This is different from the old use of len==0 which was for no length checks to be done.

util_str.c の 1213 行で定義されています。

参照先 strstr_m().

参照元 _reg_shutdown_ex()・ads_build_domain()・chgpasswd()・do_cd()・dos_clean_name()・fetch_account_info()・find_service()・ldapsam_add_sam_account()・ldapsam_search_suffix_by_name()・ldapsam_setsampwent()・load_msg()・main()・parse_lpq_aix()・parse_lpq_hpux()・parse_lpq_plp()・parse_lpq_qnx()・parse_quota_set()・pdb_default_create_user()・pwd_sub()・run_netbench()・smb_create_user()・smb_delete_user()・smb_set_primary_group()・smbc_parse_path()・special_char_sub()・sync_browse_lists()・tstring()・unix_clean_name()・wins_write_database()・ws_name_replace()・ws_name_return().

{
        char *p;
        ssize_t ls,lp,li;

        if (!insert || !pattern || !s)
                return;

        ls = (ssize_t)strlen(s);
        lp = (ssize_t)strlen(pattern);
        li = (ssize_t)strlen(insert);

        if (!*pattern)
                return;
        
        if (len == 0)
                len = ls + 1; /* len is number of *bytes* */
        
        while (lp <= ls && (p = strstr_m(s,pattern))) {
                if (ls + (li-lp) >= len) {
                        DEBUG(0,("ERROR: string overflow by %d in all_string_sub(%.50s, %d)\n", 
                                 (int)(ls + (li-lp) - len),
                                 pattern, (int)len));
                        break;
                }
                if (li != lp) {
                        memmove(p+li,p+lp,strlen(p+lp)+1);
                }
                memcpy(p, insert, li);
                s = p + li;
                ls += (li-lp);
        }
}

static smb_ucs2_t* all_string_sub_w	(	const smb_ucs2_t *	s,
		const smb_ucs2_t *	pattern,
		const smb_ucs2_t *	insert
	)			[static]

Similar to all_string_sub but for unicode strings.

Return a new allocated unicode string. similar to string_sub() but allows for any character to be substituted. Use with caution!

util_str.c の 1254 行で定義されています。

参照先 strlen_w()・strstr_w().

参照元 all_string_sub_wa().

{
        smb_ucs2_t *r, *rp;
        const smb_ucs2_t *sp;
        size_t  lr, lp, li, lt;

        if (!insert || !pattern || !*pattern || !s)
                return NULL;

        lt = (size_t)strlen_w(s);
        lp = (size_t)strlen_w(pattern);
        li = (size_t)strlen_w(insert);

        if (li > lp) {
                const smb_ucs2_t *st = s;
                int ld = li - lp;
                while ((sp = strstr_w(st, pattern))) {
                        st = sp + lp;
                        lt += ld;
                }
        }

        r = rp = SMB_MALLOC_ARRAY(smb_ucs2_t, lt + 1);
        if (!r) {
                DEBUG(0, ("all_string_sub_w: out of memory!\n"));
                return NULL;
        }

        while ((sp = strstr_w(s, pattern))) {
                memcpy(rp, s, (sp - s));
                rp += ((sp - s) / sizeof(smb_ucs2_t));
                memcpy(rp, insert, (li * sizeof(smb_ucs2_t)));
                s = sp + lp;
                rp += li;
        }
        lr = ((rp - r) / sizeof(smb_ucs2_t));
        if (lr < lt) {
                memcpy(rp, s, ((lt - lr) * sizeof(smb_ucs2_t)));
                rp += (lt - lr);
        }
        *rp = 0;

        return r;
}

smb_ucs2_t* all_string_sub_wa	(	smb_ucs2_t *	s,
		const char *	pattern,
		const char *	insert
	)

util_str.c の 1300 行で定義されています。

参照先 all_string_sub_w()・push_ucs2().

{
        wpstring p, i;

        if (!insert || !pattern || !s)
                return NULL;
        push_ucs2(NULL, p, pattern, sizeof(wpstring) - 1, STR_TERMINATE);
        push_ucs2(NULL, i, insert, sizeof(wpstring) - 1, STR_TERMINATE);
        return all_string_sub_w(s, p, i);
}

static void split_at_last_component	(	char *	path,
		char *	front,
		char	sep,
		char *	back
	)			[static]

Splits out the front and back at a separator.

util_str.c の 1317 行で定義されています。

参照先 strrchr_m().

{
        char *p = strrchr_m(path, sep);

        if (p != NULL)
                *p = 0;

        if (front != NULL)
                pstrcpy(front, path);

        if (p != NULL) {
                if (back != NULL)
                        pstrcpy(back, p+1);
                *p = '\\';
        } else {
                if (back != NULL)
                        back[0] = 0;
        }
}

const char* octal_string

(

int

i

)

Write an octal as a string.

util_str.c の 1342 行で定義されています。

参照元 print_parameter()・show_parameter().

{
        static char ret[64];
        if (i == -1)
                return "-1";
        slprintf(ret, sizeof(ret)-1, "0%o", i);
        return ret;
}

char* string_truncate	(	char *	s,
		unsigned int	length
	)

Truncate a string at a specified length.

util_str.c の 1356 行で定義されています。

参照元 _srv_net_srv_get_info()・announce_remote()・initiate_myworkgroup_startup()・mangle_map()・write_browse_list().

{
        if (s && strlen(s) > length)
                s[length] = 0;
        return s;
}

char* strchr_m	(	const char *	src,
		char	c
	)

Strchr and strrchr_m are very hard to do on general multi-byte strings.

We convert via ucs2 for now.

util_str.c の 1368 行で定義されています。

参照先 pull_ucs2_pstring()・push_ucs2()・strchr_w().

参照元 ads_keytab_add_entry()・ads_keytab_create_default()・ads_krb5_set_password()・ads_pull_username()・ads_startup_int()・aix_cache_reload()・alloc_sub_advanced()・alloc_sub_basic()・alpha_strcpy_fn()・announce_remote()・api_DosPrintQGetInfo()・Atoic()・automount_path()・base64_decode_data_blob()・cgi_download()・cgi_handle_authorization()・cgi_load_variables()・cgi_setup()・check_printer_ok()・clean_path()・cli_resolve_path()・cli_session_setup()・cli_session_setup_spnego()・connect_one()・do_connect()・do_connection()・encode_krb5_setpw()・expand_msdfs_readlink()・expand_msdfs_target()・FindSectionEnd()・get_credentials_file()・get_mydnsdomname()・get_myname()・get_real_name()・get_user_and_realm()・getlmhostsent()・grab_line()・interpret_interface()・is_ipaddress()・is_mangled()・is_ntfs_stream_name()・kerberos_secrets_store_salting_principal()・lookup_name()・lookup_name_smbconf()・main()・make_dir_struct()・manage_gss_spnego_request()・map_username()・ms_fnmatch_lanman_core()・name_to_fqdn()・net_ads_password()・net_lookup_host()・net_update_dns_internal()・net_usershare_add()・new_afs_ace()・next_command()・next_token_internal()・nfs_quotas()・only_ipaddrs_in_list()・parse_ace()・parse_acl_string()・parse_afs_acl()・parse_dfs_path()・parse_lpq_aix()・parse_lpq_entry()・parse_lpq_hpux()・parse_lpq_lprng()・parse_lpq_nt()・parse_lpq_plp()・parse_lpq_sysv()・parse_mount_smb()・parse_quota_set()・pcap_cache_reload()・plus_to_space_unescape()・popt_common_credentials_callback()・print_parameter()・process_command_string()・put_nmb_name()・read_target_host()・realloc_expand_env_var()・realloc_expand_longvar()・reply_spnego_kerberos()・reply_tcon_and_X()・rfc1738_unescape()・set_namearray()・set_printer_hnd_name()・set_printer_hnd_printertype()・set_socket_options()・show_parameter()・smb_file_rename_information()・smb_getpwnam()・smbc_parse_path()・split_dfs_path()・startsmbfilepwent()・strhex_to_str()・string_match()・strncpyn()・strstr_m()・sys_fgetxattr()・sys_fremovexattr()・sys_fsetxattr()・sys_gethostbyname()・sys_getxattr()・sys_lgetxattr()・sys_lremovexattr()・sys_lsetxattr()・sys_removexattr()・sys_setxattr()・sysv_cache_reload()・talloc_sub_specified()・terminate_path_at_separator()・toktocliplist()・unpack_values()・update_printer()・usergrp_display()・validate_net_name()・vfs_init_custom()・wins_hook()・writetarheader().

{
        wpstring ws;
        pstring s2;
        smb_ucs2_t *p;
        const char *s;

        /* characters below 0x3F are guaranteed to not appear in
           non-initial position in multi-byte charsets */
        if ((c & 0xC0) == 0) {
                return strchr(src, c);
        }

        /* this is quite a common operation, so we want it to be
           fast. We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars) */

        for (s = src; *s && !(((unsigned char)s[0]) & 0x80); s++) {
                if (*s == c)
                        return (char *)s;
        }

        if (!*s)
                return NULL;

#ifdef BROKEN_UNICODE_COMPOSE_CHARACTERS
        /* With compose characters we must restart from the beginning. JRA. */
        s = src;
#endif

        push_ucs2(NULL, ws, s, sizeof(ws), STR_TERMINATE);
        p = strchr_w(ws, UCS2_CHAR(c));
        if (!p)
                return NULL;
        *p = 0;
        pull_ucs2_pstring(s2, ws);
        return (char *)(s+strlen(s2));
}

char* strrchr_m	(	const char *	s,
		char	c
	)

util_str.c の 1408 行で定義されています。

参照先 len・pull_ucs2_pstring()・push_ucs2()・strrchr_w().

参照元 _ntsvcs_get_device_reg_property()・call_trans2findfirst()・call_trans2qfilepathinfo()・check_magic()・clean_path()・cmd_print()・copy_file()・dfs_path_lookup()・do_list_helper()・dos_clean_name()・dump_core_setup()・generic_job_submit()・get_lanman2_dir_entry()・init_reply_dfs_info_3()・is_executable()・is_in_path()・is_myname_or_ipaddr()・main()・parent_dirname()・parent_dirname_talloc()・parse_lpq_aix()・parse_lpq_plp()・parse_lpq_qnx()・reduce_name()・reg_test()・rename_internals()・rename_internals_fsp()・reply_copy()・reply_ctemp()・reply_search()・reply_tcon()・resolve_wildcards()・set_ea_dos_attribute()・set_logfile()・setup_logging()・smb_file_rename_information()・smb_set_file_unix_link()・split_at_last_component()・stat_cache_lookup()・unix_clean_name()・unix_convert()・unlink_internals()・writetarheader().

{
        /* characters below 0x3F are guaranteed to not appear in
           non-initial position in multi-byte charsets */
        if ((c & 0xC0) == 0) {
                return strrchr(s, c);
        }

        /* this is quite a common operation, so we want it to be
           fast. We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars). Also, in Samba
           we only search for ascii characters in 'c' and that
           in all mb character sets with a compound character
           containing c, if 'c' is not a match at position
           p, then p[-1] > 0x7f. JRA. */

        {
                size_t len = strlen(s);
                const char *cp = s;
                BOOL got_mb = False;

                if (len == 0)
                        return NULL;
                cp += (len - 1);
                do {
                        if (c == *cp) {
                                /* Could be a match. Part of a multibyte ? */
                                if ((cp > s) && (((unsigned char)cp[-1]) & 0x80)) {
                                        /* Yep - go slow :-( */
                                        got_mb = True;
                                        break;
                                }
                                /* No - we have a match ! */
                                return (char *)cp;
                        }
                } while (cp-- != s);
                if (!got_mb)
                        return NULL;
        }

        /* String contained a non-ascii char. Slow path. */
        {
                wpstring ws;
                pstring s2;
                smb_ucs2_t *p;

                push_ucs2(NULL, ws, s, sizeof(ws), STR_TERMINATE);
                p = strrchr_w(ws, UCS2_CHAR(c));
                if (!p)
                        return NULL;
                *p = 0;
                pull_ucs2_pstring(s2, ws);
                return (char *)(s+strlen(s2));
        }
}

char* strnrchr_m	(	const char *	s,
		char	c,
		unsigned int	n
	)

util_str.c の 1470 行で定義されています。

参照先 pull_ucs2_pstring()・push_ucs2()・strnrchr_w().

参照元 stat_cache_lookup().

{
        wpstring ws;
        pstring s2;
        smb_ucs2_t *p;

        push_ucs2(NULL, ws, s, sizeof(ws), STR_TERMINATE);
        p = strnrchr_w(ws, UCS2_CHAR(c), n);
        if (!p)
                return NULL;
        *p = 0;
        pull_ucs2_pstring(s2, ws);
        return (char *)(s+strlen(s2));
}

char* strstr_m	(	const char *	src,
		const char *	findstr
	)

util_str.c の 1489 行で定義されています。

参照先 pull_ucs2_allocate()・push_ucs2_allocate()・strchr_m()・strstr_w().

参照元 aix_cache_reload()・all_string_sub()・chgpasswd()・do_global_checks()・dos_clean_name()・find_service()・main()・manage_ntlm_change_password_1_request()・manage_ntlm_server_1_request()・parse_lpq_entry()・pcap_cache_reload()・realloc_string_sub()・str_list_substitute()・string_sub2()・talloc_string_sub()・unix_clean_name().

{
        smb_ucs2_t *p;
        smb_ucs2_t *src_w, *find_w;
        const char *s;
        char *s2;
        char *retp;

        size_t findstr_len = 0;

        /* for correctness */
        if (!findstr[0]) {
                return (char*)src;
        }

        /* Samba does single character findstr calls a *lot*. */
        if (findstr[1] == '\0')
                return strchr_m(src, *findstr);

        /* We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars) */

        for (s = src; *s && !(((unsigned char)s[0]) & 0x80); s++) {
                if (*s == *findstr) {
                        if (!findstr_len) 
                                findstr_len = strlen(findstr);

                        if (strncmp(s, findstr, findstr_len) == 0) {
                                return (char *)s;
                        }
                }
        }

        if (!*s)
                return NULL;

#if 1 /* def BROKEN_UNICODE_COMPOSE_CHARACTERS */
        /* 'make check' fails unless we do this */

        /* With compose characters we must restart from the beginning. JRA. */
        s = src;
#endif

        if (push_ucs2_allocate(&src_w, src) == (size_t)-1) {
                DEBUG(0,("strstr_m: src malloc fail\n"));
                return NULL;
        }
        
        if (push_ucs2_allocate(&find_w, findstr) == (size_t)-1) {
                SAFE_FREE(src_w);
                DEBUG(0,("strstr_m: find malloc fail\n"));
                return NULL;
        }

        p = strstr_w(src_w, find_w);

        if (!p) {
                SAFE_FREE(src_w);
                SAFE_FREE(find_w);
                return NULL;
        }
        
        *p = 0;
        if (pull_ucs2_allocate(&s2, src_w) == (size_t)-1) {
                SAFE_FREE(src_w);
                SAFE_FREE(find_w);
                DEBUG(0,("strstr_m: dest malloc fail\n"));
                return NULL;
        }
        retp = (char *)(s+strlen(s2));
        SAFE_FREE(src_w);
        SAFE_FREE(find_w);
        SAFE_FREE(s2);
        return retp;
}

void strlower_m

(

char *

s

)

Convert a string to lower case.

util_str.c の 1570 行で定義されています。

参照先 errno・len・tolower_ascii()・unix_strlower().

参照元 _dfs_Remove()・_lsa_query_info2()・ads_add_service_principal_name()・ads_build_domain()・ads_guess_service_principal()・ads_join_realm()・ads_leave_realm()・ads_verify_ticket()・afs_login()・canonicalize_servicename()・check_name_to_ntstatus_security()・do_get()・do_mget()・elog_tdbname()・fill_domain_username()・fill_dsrole_dominfo_basic()・fill_sam_account()・find_service()・get_dc_list()・Get_Pwnam_internals()・get_real_name()・getpwsid_queryuser_recv()・init_names()・kerberos_standard_des_salt()・ldapsam_rename_sam_account()・make_connection()・make_krb5_skew_error()・make_printer_tdbkey()・make_printers_secdesc_tdbkey()・make_pw_chat()・name_to_sid()・negprot_spnego()・net_ads_changetrustpw()・net_rpc_join_newstyle()・net_set_machine_spn()・net_update_dns()・net_usershare_info()・net_usershare_list()・netdom_join_domain()・netdom_leave_domain()・new_machine()・ntlmssp_server_negotiate()・offer_gss_spnego_mechs()・parse_lpq_entry()・pass_check()・pdb_default_create_user()・pdb_default_delete_user()・process_root()・rpc_oldjoin_internals()・set_local_machine_name()・set_remote_machine_name()・strnorm()・sub_set_smb_name()・tdb_delete_samacct_only()・tdb_update_ridrec_only()・tdb_update_samacct_only()・tdbsam_delete_sam_account()・tdbsam_getsampwnam()・tdbsam_rename_sam_account()・unix_wild_match()・user_in_netgroup()・winbindd_dual_pam_auth()・winbindd_fill_pwent()・winbindd_raw_kerberos_login()・writetarheader().

{
        size_t len;
        int errno_save;

        /* this is quite a common operation, so we want it to be
           fast. We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars) */

        while (*s && !(((unsigned char)s[0]) & 0x80)) {
                *s = tolower_ascii((unsigned char)*s);
                s++;
        }

        if (!*s)
                return;

        /* I assume that lowercased string takes the same number of bytes
         * as source string even in UTF-8 encoding. (VIV) */
        len = strlen(s) + 1;
        errno_save = errno;
        errno = 0;
        unix_strlower(s,len,s,len);     
        /* Catch mb conversion errors that may not terminate. */
        if (errno)
                s[len-1] = '\0';
        errno = errno_save;
}

void strupper_m

(

char *

s

)

Convert a string to upper case.

util_str.c の 1604 行で定義されています。

参照先 errno・len・toupper_ascii()・unix_strupper().

参照元 _samr_enum_domains()・_spoolss_enumprinters()・ads_add_service_principal_name()・ads_cached_connection()・ads_dc_name()・ads_guess_service_principal()・ads_keytab_create_default()・ads_startup_int()・ads_try_connect()・announce_local_master_browser_to_domain_master_browser()・api_NetWkstaGetInfo()・api_WWkstaUserLogon()・browse_sync_remote()・check_name_to_ntstatus_security()・cli_NetWkstaUserLogoff()・cli_NetWkstaUserLogon()・cli_session_setup_spnego()・cmd_samr_query_group()・cmd_samr_query_groupmem()・cmd_samr_query_sec_obj()・cmd_samr_query_user()・cmd_samr_query_useraliases()・cmd_samr_query_usergroups()・cmd_spoolss_addform()・cmd_spoolss_addprinterex()・cmd_spoolss_deletedriver()・cmd_spoolss_deleteform()・cmd_spoolss_enum_data()・cmd_spoolss_enum_data_ex()・cmd_spoolss_enum_forms()・cmd_spoolss_enum_jobs()・cmd_spoolss_enum_printerkey()・cmd_spoolss_enum_printers()・cmd_spoolss_getdriver()・cmd_spoolss_getform()・cmd_spoolss_getprinter()・cmd_spoolss_getprinterdata()・cmd_spoolss_getprinterdataex()・cmd_spoolss_getprintprocdir()・cmd_spoolss_open_printer_ex()・cmd_spoolss_printercmp()・cmd_spoolss_rffpcnex()・cmd_spoolss_setdriver()・cmd_spoolss_setform()・cmd_spoolss_setprinter()・cmd_spoolss_setprinterdata()・cmd_spoolss_setprintername()・cmd_wks_query_info()・construct_printer_info_7()・copy_service()・create_browser_in_lmb_cache()・create_local_private_krb5_conf_for_domain()・create_server_on_workgroup()・create_wks_info_100()・fill_printdest_info()・Get_Pwnam_internals()・get_trust_creds()・get_user_tokens()・idmap_fetch_secret()・idmap_store_secret()・init_r_trust_dom()・lookup_cached_name()・lookup_name()・lp_do_parameter()・main()・make_nmb_name()・mangle_hash()・my_make_nmb_name()・name_mangle()・name_to_key()・name_to_sid()・net_rpc_join_newstyle()・net_set_machine_spn()・normalize_reg_path()・parse_domain_user()・parse_ntlm_auth_domain_user()・parse_wbinfo_domain_user()・process_node_status_request()・push_ascii()・push_utf8()・regdb_fetch_keys()・rpc_trustdom_add_internals()・rpc_trustdom_del_internals()・rpc_trustdom_establish()・rpc_trustdom_list()・rpc_trustdom_revoke()・rpccli_spoolss_addprinterdriver()・rpccli_spoolss_addprinterex()・rpccli_spoolss_deleteprinterdriver()・rpccli_spoolss_deleteprinterdriverex()・rpccli_spoolss_enum_ports()・rpccli_spoolss_enumprinterdrivers()・rpccli_spoolss_getprinterdriver()・rpccli_spoolss_getprinterdriverdir()・rpccli_srvsvc_net_file_close()・rpccli_srvsvc_net_file_enum()・rpccli_srvsvc_net_remote_tod()・rpccli_srvsvc_net_share_add()・rpccli_srvsvc_net_share_del()・rpccli_srvsvc_net_share_enum()・rpccli_srvsvc_net_share_get_info()・rpccli_srvsvc_net_share_set_info()・rpccli_srvsvc_net_srv_get_info()・secrets_fetch_domain_guid()・secrets_fetch_domain_sid()・secrets_fetch_machine_password()・secrets_restore_schannel_session_info()・secrets_store_domain_guid()・secrets_store_domain_sid()・secrets_store_machine_password()・secrets_store_schannel_session_info()・send_announcement()・send_backup_list_response()・send_election_dgram()・server_cryptkey()・set_global_myname()・set_global_myname_override()・set_global_myworkgroup()・set_global_scope()・set_my_netbios_names()・share_sanity_checks()・strnorm()・strupper_static()・to_8_3()・trust_keystr()・trustdom_keystr()・upcase_name()・wcache_save_name_to_sid()・winbindd_dual_pam_auth_cached()・winbindd_raw_kerberos_login().

{
        size_t len;
        int errno_save;

        /* this is quite a common operation, so we want it to be
           fast. We optimise for the ascii case, knowing that all our
           supported multi-byte character sets are ascii-compatible
           (ie. they match for the first 128 chars) */

        while (*s && !(((unsigned char)s[0]) & 0x80)) {
                *s = toupper_ascii((unsigned char)*s);
                s++;
        }

        if (!*s)
                return;

        /* I assume that lowercased string takes the same number of bytes
         * as source string even in multibyte encoding. (VIV) */
        len = strlen(s) + 1;
        errno_save = errno;
        errno = 0;
        unix_strupper(s,len,s,len);     
        /* Catch mb conversion errors that may not terminate. */
        if (errno)
                s[len-1] = '\0';
        errno = errno_save;
}

size_t strlen_m

(

const char *

s

)

Count the number of UCS2 characters in a string.

Normally this will be the same as the number of bytes in a string for single byte strings, but will be different for multibyte.

util_str.c の 1640 行で定義されています。

参照先 c・next_codepoint().

参照元 strlen_m_term()・strlen_m_term_null().

{
        size_t count = 0;

        if (!s) {
                return 0;
        }

        while (*s && !(((uint8_t)*s) & 0x80)) {
                s++;
                count++;
        }

        if (!*s) {
                return count;
        }

        while (*s) {
                size_t c_size;
                codepoint_t c = next_codepoint(s, &c_size);
                if (c < 0x10000) {
                        /* Unicode char fits into 16 bits. */
                        count += 1;
                } else {
                        /* Double-width unicode char - 32 bits. */
                        count += 2;
                }
                s += c_size;
        }

        return count;
}

size_t strlen_m_term

(

const char *

s

)

Count the number of UCS2 characters in a string including the null terminator.

util_str.c の 1678 行で定義されています。

参照先 strlen_m().

{
        if (!s) {
                return 0;
        }
        return strlen_m(s) + 1;
}

size_t strlen_m_term_null

(

const char *

s

)

util_str.c の 1691 行で定義されています。

参照先 len・strlen_m().

{
        size_t len;
        if (!s) {
                return 0;
        }
        len = strlen_m(s);
        if (len == 0) {
                return 0;
        }

        return len+1;
}

char* binary_string_rfc2254	(	char *	buf,
		int	len
	)

Return a RFC2254 binary string representation of a buffer.

Used in LDAP filters. Caller must free.

util_str.c の 1710 行で定義されています。

参照元 sid_binstring().

{
        char *s;
        int i, j;
        const char *hex = "0123456789ABCDEF";
        s = (char *)SMB_MALLOC(len * 3 + 1);
        if (!s)
                return NULL;
        for (j=i=0;i<len;i++) {
                s[j] = '\\';
                s[j+1] = hex[((unsigned char)buf[i]) >> 4];
                s[j+2] = hex[((unsigned char)buf[i]) & 0xF];
                j += 3;
        }
        s[j] = 0;
        return s;
}

char* binary_string	(	char *	buf,
		int	len
	)

util_str.c の 1728 行で定義されています。

参照元 sid_binstring_hex().

{
        char *s;
        int i, j;
        const char *hex = "0123456789ABCDEF";
        s = (char *)SMB_MALLOC(len * 2 + 1);
        if (!s)
                return NULL;
        for (j=i=0;i<len;i++) {
                s[j]   = hex[((unsigned char)buf[i]) >> 4];
                s[j+1] = hex[((unsigned char)buf[i]) & 0xF];
                j += 2;
        }
        s[j] = 0;
        return s;
}

int pstr_sprintf	(	pstring	s,
		const char *	fmt,
			...
	)

Just a typesafety wrapper for snprintf into a pstring.

util_str.c の 1748 行で定義されています。

参照先 vsnprintf().

参照元 add_new_domain_account_policies()・add_new_domain_info()・add_new_svc_name()・call_trans2qfilepathinfo()・cli_check_msdfs_proxy()・cli_dfs_make_full_path()・cli_resolve_path()・cmd_spoolss_printercmp()・copy_registry_tree()・create_pipe_sock()・cups_job_submit()・delete_printer_hook()・do_del()・dump_registry_tree()・elog_tdbname()・enum_file_fn()・eventlog_add_source()・eventlog_init_keys()・fetch_account_info_to_ldif()・fetch_alias_info_to_ldif()・fetch_group_info_to_ldif()・fetch_groupmem_info_to_ldif()・fill_service_values()・find_fn()・fork_child_dc_connect()・form_junctions()・get_dc_list()・get_device_path()・get_parm_translated()・ldapsam_add_sam_account()・ldapsam_enum_aliasmem()・ldapsam_get_seq_num()・ldapsam_getgrgid()・ldapsam_getgrnam()・ldapsam_getgrsid()・ldapsam_modify_aliasmem()・ldapsam_search_suffix_by_name()・ldapsam_search_suffix_by_rid()・ldapsam_search_suffix_by_sid()・ldapsam_setsamgrent()・ldapsam_setsampwent()・lp_do_parameter()・main()・make_printer_tdbkey()・make_printers_secdesc_tdbkey()・manage_client_krb5_init()・manage_gss_spnego_request()・map_populate_groups()・map_username()・offer_gss_spnego_mechs()・open_registry_key()・pdb_init_tdbsam()・popt_common_callback()・popt_common_credentials_callback()・rcinit_start()・rcinit_status()・rcinit_stop()・read_init_file()・reg_load_tree()・reg_write_tree()・regdb_fetch_values()・regdb_store_keys()・regdb_store_values()・remote_completion()・set_logfile()・setup_domain_child()・smbldap_search_domain_info()・svcctl_fetch_regvalues()・svcctl_get_secdesc()・svcctl_lookup_description()・svcctl_lookup_dispname()・svcctl_set_secdesc()・sync_eventlog_params()・terminate()・trustdom_keystr()・validate_my_share_entries()・write_registry_tree()・xcvtcp_addport().

{
        va_list ap;
        int ret;

        va_start(ap, fmt);
        ret = vsnprintf(s, PSTRING_LEN, fmt, ap);
        va_end(ap);
        return ret;
}

int fstr_sprintf	(	fstring	s,
		const char *	fmt,
			...
	)

Just a typesafety wrapper for snprintf into a fstring.

util_str.c の 1764 行で定義されています。

参照先 vsnprintf().

参照元 _net_logon_ctrl2()・_reg_shutdown_ex()・_samr_set_aliasinfo()・add_new_domain_info()・add_signature()・ads_kinit_password()・asn1_read_OID()・cache_cleanup_response()・cache_retrieve_response()・cache_store_response()・cli_session_setup_plaintext()・cmd_srvsvc_net_remote_tod()・counters_directory()・create_builtin_administrators()・current_version()・display_time()・do_ccache_ntlm_auth()・do_log()・dump_regval_type()・fetch_cache_seqnum()・fill_sam_account()・get_common_service_dispname()・get_objclass_filter()・get_privileges()・get_queue_status()・get_user_sids()・kerberos_standard_des_salt()・lib_path()・mailslot_name()・main()・map_nt_printer_info2_to_dsspooler()・netsamlogon_clear_cached_user()・procid_str_static()・quota_str_static()・reply_spnego_kerberos()・rpccli_net_auth2()・rpccli_netlogon_sam_logon()・rpccli_netlogon_setup_creds()・rpccli_svcctl_open_scm()・run_error_map_extract()・run_test()・send_getdc_request()・set_privileges()・sid_to_name()・smb_getpwnam()・store_cache_seqnum()・svc_status_string()・systime()・test_one()・traverse_sessionid()・trustdom_cache_store_timestamp()・unparse_afs_acl()・wcache_cached_creds_exist()・wcache_remove_oldest_cached_creds().

{
        va_list ap;
        int ret;

        va_start(ap, fmt);
        ret = vsnprintf(s, FSTRING_LEN, fmt, ap);
        va_end(ap);
        return ret;
}

static char** str_list_make_internal	(	TALLOC_CTX *	mem_ctx,
		const char *	string,
		const char *	sep
	)			[static]

util_str.c の 1781 行で定義されています。

参照先 list()・next_token()・str_list_free()・talloc_strdup().

参照元 str_list_make()・str_list_make_talloc().

{
        char **list, **rlist;
        const char *str;
        char *s;
        int num, lsize;
        pstring tok;
        
        if (!string || !*string)
                return NULL;
        if (mem_ctx) {
                s = talloc_strdup(mem_ctx, string);
        } else {
                s = SMB_STRDUP(string);
        }
        if (!s) {
                DEBUG(0,("str_list_make: Unable to allocate memory"));
                return NULL;
        }
        if (!sep) sep = LIST_SEP;
        
        num = lsize = 0;
        list = NULL;
        
        str = s;
        while (next_token(&str, tok, sep, sizeof(tok))) {               
                if (num == lsize) {
                        lsize += S_LIST_ABS;
                        if (mem_ctx) {
                                rlist = TALLOC_REALLOC_ARRAY(mem_ctx, list, char *, lsize +1);
                        } else {
                                /* We need to keep the old list on error so we can free the elements
                                   if the realloc fails. */
                                rlist = SMB_REALLOC_ARRAY_KEEP_OLD_ON_ERROR(list, char *, lsize +1);
                        }
                        if (!rlist) {
                                DEBUG(0,("str_list_make: Unable to allocate memory"));
                                str_list_free(&list);
                                if (mem_ctx) {
                                        TALLOC_FREE(s);
                                } else {
                                        SAFE_FREE(s);
                                }
                                return NULL;
                        } else {
                                list = rlist;
                        }
                        memset (&list[num], 0, ((sizeof(char**)) * (S_LIST_ABS +1)));
                }

                if (mem_ctx) {
                        list[num] = talloc_strdup(mem_ctx, tok);
                } else {
                        list[num] = SMB_STRDUP(tok);
                }
                
                if (!list[num]) {
                        DEBUG(0,("str_list_make: Unable to allocate memory"));
                        str_list_free(&list);
                        if (mem_ctx) {
                                TALLOC_FREE(s);
                        } else {
                                SAFE_FREE(s);
                        }
                        return NULL;
                }
        
                num++;  
        }

        if (mem_ctx) {
                TALLOC_FREE(s);
        } else {
                SAFE_FREE(s);
        }

        return list;
}

char** str_list_make_talloc	(	TALLOC_CTX *	mem_ctx,
		const char *	string,
		const char *	sep
	)

util_str.c の 1860 行で定義されています。

参照先 str_list_make_internal().

参照元 ads_parse_gp_ext()・ads_parse_gplink().

{
        return str_list_make_internal(mem_ctx, string, sep);
}

char** str_list_make	(	const char *	string,
		const char *	sep
	)

util_str.c の 1865 行で定義されています。

参照先 str_list_make_internal().

参照元 debug_parse_levels()・handle_netbios_aliases()・init_globals()・lp_do_parameter()・lp_parm_string_list()・make_auth_context_subsystem()・map_username()・user_ok()・web_set_lang().

{
        return str_list_make_internal(NULL, string, sep);
}

BOOL str_list_copy	(	char ***	dest,
		const char **	src
	)

util_str.c の 1870 行で定義されています。

参照先 list()・str_list_free().

参照元 ads_do_paged_search_args()・ads_do_search()・copy_service()・lp_save_defaults()・make_auth_context_subsystem()・user_ok().

{
        char **list, **rlist;
        int num, lsize;
        
        *dest = NULL;
        if (!src)
                return False;
        
        num = lsize = 0;
        list = NULL;
                
        while (src[num]) {
                if (num == lsize) {
                        lsize += S_LIST_ABS;
                        rlist = SMB_REALLOC_ARRAY_KEEP_OLD_ON_ERROR(list, char *, lsize +1);
                        if (!rlist) {
                                DEBUG(0,("str_list_copy: Unable to re-allocate memory"));
                                str_list_free(&list);
                                return False;
                        } else {
                                list = rlist;
                        }
                        memset (&list[num], 0, ((sizeof(char **)) * (S_LIST_ABS +1)));
                }
                
                list[num] = SMB_STRDUP(src[num]);
                if (!list[num]) {
                        DEBUG(0,("str_list_copy: Unable to allocate memory"));
                        str_list_free(&list);
                        return False;
                }

                num++;
        }
        
        *dest = list;
        return True;    
}

BOOL str_list_compare	(	char **	list1,
		char **	list2
	)

Return true if all the elements of the list match exactly.

util_str.c の 1913 行で定義されています。

参照先 strcsequal().

参照元 equal_parameter()・is_default()・show_parameters().

{
        int num;
        
        if (!list1 || !list2)
                return (list1 == list2); 
        
        for (num = 0; list1[num]; num++) {
                if (!list2[num])
                        return False;
                if (!strcsequal(list1[num], list2[num]))
                        return False;
        }
        if (list2[num])
                return False; /* if list2 has more elements than list1 fail */
        
        return True;
}

static void str_list_free_internal	(	TALLOC_CTX *	mem_ctx,
		char ***	list
	)			[static]

util_str.c の 1932 行で定義されています。

参照元 str_list_free()・str_list_free_talloc().

{
        char **tlist;
        
        if (!list || !*list)
                return;
        tlist = *list;
        for(; *tlist; tlist++) {
                if (mem_ctx) {
                        TALLOC_FREE(*tlist);
                } else {
                        SAFE_FREE(*tlist);
                }
        }
        if (mem_ctx) {
                TALLOC_FREE(*tlist);
        } else {
                SAFE_FREE(*list);
        }
}

void str_list_free_talloc	(	TALLOC_CTX *	mem_ctx,
		char ***	list
	)

util_str.c の 1953 行で定義されています。

参照先 str_list_free_internal().

参照元 ads_parse_gplink().

{
        str_list_free_internal(mem_ctx, list);
}

void str_list_free

(

char ***

list

)

util_str.c の 1958 行で定義されています。

参照先 str_list_free_internal().

参照元 add_a_service()・ads_do_paged_search_args()・ads_do_search()・copy_service()・debug_parse_levels()・free_service()・handle_netbios_aliases()・lp_do_parameter()・make_auth_context_subsystem()・map_username()・str_list_copy()・str_list_make_internal()・user_ok()・web_set_lang().

{
        str_list_free_internal(NULL, list);
}

int str_list_count

(

const char **

list

)

util_str.c の 1966 行で定義されています。

参照元 init_service_op_table().

{
        int i = 0;

        if ( ! list )
                return 0;

        /* count the number of list members */
        
        for ( i=0; *list; i++, list++ );
        
        return i;
}

BOOL str_list_sub_basic	(	char **	list,
		const char *	smb_name,
		const char *	domain_name
	)

util_str.c の 1985 行で定義されています。

参照先 alloc_sub_basic().

参照元 user_ok().

{
        char *s, *tmpstr;
        
        while ( *list ) {
                s = *list;
                tmpstr = alloc_sub_basic(smb_name, domain_name, s);
                if ( !tmpstr ) {
                        DEBUG(0,("str_list_sub_basic: alloc_sub_basic() return NULL!\n"));
                        return False;
                }

                SAFE_FREE(*list);
                *list = tmpstr;
                        
                list++;
        }

        return True;
}

BOOL str_list_substitute	(	char **	list,
		const char *	pattern,
		const char *	insert
	)

util_str.c の 2011 行で定義されています。

参照先 strstr_m()・t.

参照元 user_ok().

{
        char *p, *s, *t;
        ssize_t ls, lp, li, ld, i, d;

        if (!list)
                return False;
        if (!pattern)
                return False;
        if (!insert)
                return False;

        lp = (ssize_t)strlen(pattern);
        li = (ssize_t)strlen(insert);
        ld = li -lp;
                        
        while (*list) {
                s = *list;
                ls = (ssize_t)strlen(s);

                while ((p = strstr_m(s, pattern))) {
                        t = *list;
                        d = p -t;
                        if (ld) {
                                t = (char *) SMB_MALLOC(ls +ld +1);
                                if (!t) {
                                        DEBUG(0,("str_list_substitute: Unable to allocate memory"));
                                        return False;
                                }
                                memcpy(t, *list, d);
                                memcpy(t +d +li, p +lp, ls -d -lp +1);
                                SAFE_FREE(*list);
                                *list = t;
                                ls += ld;
                                s = t +d +li;
                        }
                        
                        for (i = 0; i < li; i++) {
                                switch (insert[i]) {
                                        case '`':
                                        case '"':
                                        case '\'':
                                        case ';':
                                        case '$':
                                        case '%':
                                        case '\r':
                                        case '\n':
                                                t[d +i] = '_';
                                                break;
                                        default:
                                                t[d +i] = insert[i];
                                }
                        }       
                }
                
                
                list++;
        }
        
        return True;
}

char* ipstr_list_add	(	char **	ipstr_list,
		const struct ip_service *	service
	)

Add ip string representation to ipstr list.

Used also as part of ipstr_list_make

引数:

	ipstr_list	pointer to string containing ip list; MUST BE already allocated and IS reallocated if necessary
	ipstr_size	pointer to current size of ipstr_list (might be changed as a result of reallocation)
	ip	IP address which is to be added to list

戻り値:

pointer to string appended with new ip and possibly reallocated to new length

util_str.c の 2090 行で定義されています。

参照先 asprintf()・service.

参照元 ipstr_list_make().

{
        char* new_ipstr = NULL;
        
        /* arguments checking */
        if (!ipstr_list || !service) return NULL;

        /* attempt to convert ip to a string and append colon separator to it */
        if (*ipstr_list) {
                asprintf(&new_ipstr, "%s%s%s:%d", *ipstr_list, IPSTR_LIST_SEP,
                        inet_ntoa(service->ip), service->port);
                SAFE_FREE(*ipstr_list);
        } else {
                asprintf(&new_ipstr, "%s:%d", inet_ntoa(service->ip), service->port);
        }
        *ipstr_list = new_ipstr;
        return *ipstr_list;
}

char* ipstr_list_make	(	char **	ipstr_list,
		const struct ip_service *	ip_list,
		int	ip_count
	)

Allocate and initialise an ipstr list using ip adresses passed as arguments.

引数:

	ipstr_list	pointer to string meant to be allocated and set
	ip_list	array of ip addresses to place in the list
	ip_count	number of addresses stored in ip_list

戻り値:

pointer to allocated ip string

util_str.c の 2120 行で定義されています。

参照先 ipstr_list_add().

参照元 namecache_store().

{
        int i;
        
        /* arguments checking */
        if (!ip_list || !ipstr_list) return 0;

        *ipstr_list = NULL;
        
        /* process ip addresses given as arguments */
        for (i = 0; i < ip_count; i++)
                *ipstr_list = ipstr_list_add(ipstr_list, &ip_list[i]);
        
        return (*ipstr_list);
}

int ipstr_list_parse	(	const char *	ipstr_list,
		struct ip_service **	ip_list
	)

Parse given ip string list into array of ip addresses (as ip_service structures) e.g.

192.168.1.100:389,192.168.1.78, ...

引数:

	ipstr	ip string list to be parsed
	ip_list	pointer to array of ip addresses which is allocated by this function and must be freed by caller

戻り値:

number of successfully parsed addresses

util_str.c の 2148 行で定義されています。

参照先 count_chars()・next_token()・port.

参照元 namecache_fetch().

{
        fstring token_str;
        size_t count;
        int i;

        if (!ipstr_list || !ip_list) 
                return 0;
        
        count = count_chars(ipstr_list, IPSTR_LIST_CHAR) + 1;
        if ( (*ip_list = SMB_MALLOC_ARRAY(struct ip_service, count)) == NULL ) {
                DEBUG(0,("ipstr_list_parse: malloc failed for %lu entries\n", (unsigned long)count));
                return 0;
        }
        
        for ( i=0; 
                next_token(&ipstr_list, token_str, IPSTR_LIST_SEP, FSTRING_LEN) && i<count; 
                i++ ) 
        {
                struct in_addr addr;
                unsigned port = 0;      
                char *p = strchr(token_str, ':');
                
                if (p) {
                        *p = 0;
                        port = atoi(p+1);
                }

                /* convert single token to ip address */
                if ( (addr.s_addr = inet_addr(token_str)) == INADDR_NONE )
                        break;
                                
                (*ip_list)[i].ip = addr;
                (*ip_list)[i].port = port;
        }
        
        return count;
}

void ipstr_list_free

(

char *

ipstr_list

)

Safely free ip string list

引数:

ipstr_list

ip string list to be freed

util_str.c の 2194 行で定義されています。

{
        SAFE_FREE(ipstr_list);
}

void rfc1738_unescape

(

char *

buf

)

Unescape a URL encoded string, in place.

util_str.c の 2204 行で定義されています。

参照先 strchr_m().

参照元 cgi_load_variables()・manage_squid_basic_request()・uri_unescape_alloc().

{
        char *p=buf;

        while (p && *p && (p=strchr_m(p,'%'))) {
                int c1 = p[1];
                int c2 = p[2];

                if (c1 >= '0' && c1 <= '9')
                        c1 = c1 - '0';
                else if (c1 >= 'A' && c1 <= 'F')
                        c1 = 10 + c1 - 'A';
                else if (c1 >= 'a' && c1 <= 'f')
                        c1 = 10 + c1 - 'a';
                else {p++; continue;}

                if (c2 >= '0' && c2 <= '9')
                        c2 = c2 - '0';
                else if (c2 >= 'A' && c2 <= 'F')
                        c2 = 10 + c2 - 'A';
                else if (c2 >= 'a' && c2 <= 'f')
                        c2 = 10 + c2 - 'a';
                else {p++; continue;}
                        
                *p = (c1<<4) | c2;

                memmove(p+1, p+3, strlen(p+3)+1);
                p++;
        }
}

DATA_BLOB base64_decode_data_blob

(

const char *

s

)

Decode a base64 string into a DATA_BLOB - simple and slow algorithm

util_str.c の 2240 行で定義されています。

参照先 b64・data_blob_::data・data_blob()・data_blob_::length・strchr_m().

参照元 afs_decode_token()・base64_decode_inplace()・init_sam_user_info20A()・init_sam_user_info21A()・init_sam_user_info23A()・manage_client_ntlmssp_request()・manage_gss_spnego_client_request()・manage_gss_spnego_request()・manage_squid_ntlmssp_request().

{
        int bit_offset, byte_offset, idx, i, n;
        DATA_BLOB decoded = data_blob(s, strlen(s)+1);
        unsigned char *d = decoded.data;
        char *p;

        n=i=0;

        while (*s && (p=strchr_m(b64,*s))) {
                idx = (int)(p - b64);
                byte_offset = (i*6)/8;
                bit_offset = (i*6)%8;
                d[byte_offset] &= ~((1<<(8-bit_offset))-1);
                if (bit_offset < 3) {
                        d[byte_offset] |= (idx << (2-bit_offset));
                        n = byte_offset+1;
                } else {
                        d[byte_offset] |= (idx >> (bit_offset-2));
                        d[byte_offset+1] = 0;
                        d[byte_offset+1] |= (idx << (8-(bit_offset-2))) & 0xFF;
                        n = byte_offset+2;
                }
                s++; i++;
        }

        if ((n > 0) && (*s == '=')) {
                n -= 1;
        }

        /* fix up length */
        decoded.length = n;
        return decoded;
}

void base64_decode_inplace

(

char *

s

)

Decode a base64 string in-place - wrapper for the above

util_str.c の 2278 行で定義されています。

参照先 base64_decode_data_blob()・data_blob_::data・data_blob_free()・data_blob_::length.

参照元 cgi_handle_authorization()・manage_ntlm_change_password_1_request()・manage_ntlm_server_1_request().

{
        DATA_BLOB decoded = base64_decode_data_blob(s);

        if ( decoded.length != 0 ) {
                memcpy(s, decoded.data, decoded.length);

                /* null terminate */
                s[decoded.length] = '\0';
        } else {
                *s = '\0';
        }

        data_blob_free(&decoded);
}

char* base64_encode_data_blob

(

DATA_BLOB

data

)

Encode a base64 string into a malloc()ed string caller to free.

From SQUID: adopted from http://ftp.sunet.se/pub2/gnu/vm/base64-encode.c with adjustments

util_str.c の 2299 行で定義されています。

参照先 b64・c・data_blob_::data・len・data_blob_::length・result.

参照元 afs_encode_token()・copy_id20_to_sam_passwd()・copy_id21_to_sam_passwd()・copy_id23_to_sam_passwd()・copy_id25_to_sam_passwd()・fprintf_attr()・manage_client_krb5_init()・manage_client_ntlmssp_init()・manage_client_ntlmssp_request()・manage_client_ntlmssp_targ()・manage_gss_spnego_request()・manage_squid_ntlmssp_request()・offer_gss_spnego_mechs()・sam_account_from_delta().

{
        int bits = 0;
        int char_count = 0;
        size_t out_cnt, len, output_len;
        char *result;

        if (!data.length || !data.data)
                return NULL;

        out_cnt = 0;
        len = data.length;
        output_len = data.length * 2 + 4; /* Account for closing bytes. 4 is
                                           * random but should be enough for
                                           * the = and \0 */
        result = (char *)SMB_MALLOC(output_len); /* get us plenty of space */

        while (len-- && out_cnt < (data.length * 2) - 5) {
                int c = (unsigned char) *(data.data++);
                bits += c;
                char_count++;
                if (char_count == 3) {
                        result[out_cnt++] = b64[bits >> 18];
                        result[out_cnt++] = b64[(bits >> 12) & 0x3f];
                        result[out_cnt++] = b64[(bits >> 6) & 0x3f];
            result[out_cnt++] = b64[bits & 0x3f];
            bits = 0;
            char_count = 0;
        } else {
            bits <<= 8;
        }
    }
    if (char_count != 0) {
        bits <<= 16 - (8 * char_count);
        result[out_cnt++] = b64[bits >> 18];
        result[out_cnt++] = b64[(bits >> 12) & 0x3f];
        if (char_count == 1) {
            result[out_cnt++] = '=';
            result[out_cnt++] = '=';
        } else {
            result[out_cnt++] = b64[(bits >> 6) & 0x3f];
            result[out_cnt++] = '=';
        }
    }
    result[out_cnt] = '\0';     /* terminate */
    return result;
}

SMB_BIG_UINT STR_TO_SMB_BIG_UINT	(	const char *	nptr,
		const char **	entptr
	)

util_str.c の 2348 行で定義されています。

参照元 command_get_quota()・sys_disk_free().

{

        SMB_BIG_UINT val = -1;
        const char *p = nptr;
        
        if (!p) {
                if (entptr) {
                        *entptr = p;
                }
                return val;
        }

        while (*p && isspace(*p))
                p++;

#ifdef LARGE_SMB_OFF_T
        sscanf(p,"%llu",&val);  
#else /* LARGE_SMB_OFF_T */
        sscanf(p,"%lu",&val);
#endif /* LARGE_SMB_OFF_T */
        if (entptr) {
                while (*p && isdigit(*p))
                        p++;
                *entptr = p;
        }

        return val;
}

SMB_OFF_T conv_str_size

(

const char *

str

)

util_str.c の 2389 行で定義されています。

参照先 strwicmp().

参照元 commit_open()・cprime_connect()・prealloc_open()・readahead_connect()・recycle_maxsize()・recycle_minsize().

{
        SMB_OFF_T lval;
        char * end;

        if (str == NULL || *str == '\0') {
                return 0;
        }

#ifdef HAVE_STRTOULL
        if (sizeof(SMB_OFF_T) == 8) {
            lval = strtoull(str, &end, 10 /* base */);
        } else {
            lval = strtoul(str, &end, 10 /* base */);
        }
#else
        lval = strtoul(str, &end, 10 /* base */);
#endif

        if (end == NULL || end == str) {
                return 0;
        }

        if (*end) {
                SMB_OFF_T lval_orig = lval;

                if (strwicmp(end, "K") == 0) {
                        lval *= (SMB_OFF_T)1024;
                } else if (strwicmp(end, "M") == 0) {
                        lval *= ((SMB_OFF_T)1024 * (SMB_OFF_T)1024);
                } else if (strwicmp(end, "G") == 0) {
                        lval *= ((SMB_OFF_T)1024 * (SMB_OFF_T)1024 *
                                (SMB_OFF_T)1024);
                } else if (strwicmp(end, "T") == 0) {
                        lval *= ((SMB_OFF_T)1024 * (SMB_OFF_T)1024 *
                                (SMB_OFF_T)1024 * (SMB_OFF_T)1024);
                } else if (strwicmp(end, "P") == 0) {
                        lval *= ((SMB_OFF_T)1024 * (SMB_OFF_T)1024 *
                                (SMB_OFF_T)1024 * (SMB_OFF_T)1024 *
                                (SMB_OFF_T)1024);
                } else {
                        return 0;
                }

                /* Primitive attempt to detect wrapping on platforms with
                 * 4-byte SMB_OFF_T. It's better to let the caller handle
                 * a failure than some random number.
                 */
                if (lval_orig <= lval) {
                        return 0;
                }
        }

        return lval;
}

void string_append	(	char **	left,
		const char *	right
	)

util_str.c の 2445 行で定義されています。

参照元 add_member()・cli_resolve_path().

{
        int new_len = strlen(right) + 1;

        if (*left == NULL) {
                *left = (char *)SMB_MALLOC(new_len);
                *left[0] = '\0';
        } else {
                new_len += strlen(*left);
                *left = (char *)SMB_REALLOC(*left, new_len);
        }

        if (*left == NULL) {
                return;
        }

        safe_strcat(*left, right, new_len-1);
}

BOOL add_string_to_array	(	TALLOC_CTX *	mem_ctx,
		const char *	str,
		const char ***	strings,
		int *	num
	)

util_str.c の 2464 行で定義されています。

参照先 talloc_strdup().

参照元 find_new_dc()・init_r_enum_acct_rights().

{
        char *dup_str = talloc_strdup(mem_ctx, str);

        *strings = TALLOC_REALLOC_ARRAY(mem_ctx, *strings, const char *, (*num)+1);

        if ((*strings == NULL) || (dup_str == NULL)) {
                *num = 0;
                return False;
        }

        (*strings)[*num] = dup_str;
        *num += 1;
        return True;
}

void sprintf_append	(	TALLOC_CTX *	mem_ctx,
		char **	string,
		ssize_t *	len,
		size_t *	bufsize,
		const char *	fmt,
			...
	)

util_str.c の 2486 行で定義されています。

参照先 error・vasprintf().

参照元 main()・msg_pool_usage_helper()・print_sidlist()・winbind_lookup_rids()・winbindd_dual_lookuprids().

{
        va_list ap;
        char *newstr;
        int ret;
        BOOL increased;

        /* len<0 is an internal marker that something failed */
        if (*len < 0)
                goto error;

        if (*string == NULL) {
                if (*bufsize == 0)
                        *bufsize = 128;

                *string = TALLOC_ARRAY(mem_ctx, char, *bufsize);
                if (*string == NULL)
                        goto error;
        }

        va_start(ap, fmt);
        ret = vasprintf(&newstr, fmt, ap);
        va_end(ap);

        if (ret < 0)
                goto error;

        increased = False;

        while ((*len)+ret >= *bufsize) {
                increased = True;
                *bufsize *= 2;
                if (*bufsize >= (1024*1024*256))
                        goto error;
        }

        if (increased) {
                *string = TALLOC_REALLOC_ARRAY(mem_ctx, *string, char,
                                               *bufsize);
                if (*string == NULL) {
                        goto error;
                }
        }

        StrnCpy((*string)+(*len), newstr, ret);
        (*len) += ret;
        free(newstr);
        return;

 error:
        *len = -1;
        *string = NULL;
}

char* sstring_sub	(	const char *	src,
		char	front,
		char	back
	)

util_str.c の 2547 行で定義されています。

参照先 len.

参照元 fetch_account_info_to_ldif()・fetch_alias_info_to_ldif()・fetch_group_info_to_ldif()・map_populate_groups()・populate_ldap_for_ldif().

{
        char *temp1, *temp2, *temp3;
        ptrdiff_t len;

        temp1 = strchr(src, front);
        if (temp1 == NULL) return NULL;
        temp2 = strchr(src, back);
        if (temp2 == NULL) return NULL;
        len = temp2 - temp1;
        if (len <= 0) return NULL;
        temp3 = (char*)SMB_MALLOC(len);
        if (temp3 == NULL) {
                DEBUG(1,("Malloc failure in sstring_sub\n"));
                return NULL;
        }
        memcpy(temp3, temp1+1, len-1);
        temp3[len-1] = '\0';
        return temp3;
}

BOOL validate_net_name	(	const char *	name,
		const char *	invalid_chars,
		int	max_len
	)

util_str.c の 2573 行で定義されています。

参照先 strchr_m().

参照元 _srv_net_name_validate()・_srv_net_share_add()・count_num_usershares()・get_share_list()・net_usershare_add()・net_usershare_delete()・process_usershare_file().

{
        int i;

        for ( i=0; i<max_len && name[i]; i++ ) {
                /* fail if strchr_m() finds one of the invalid characters */
                if ( name[i] && strchr_m( invalid_chars, name[i] ) ) {
                        return False;
                }
        }

        return True;
}

size_t ascii_len_n	(	const char *	src,
		size_t	n
	)

return the number of bytes occupied by a buffer in ASCII format the result includes the null termination limited by 'n' bytes

util_str.c の 2593 行で定義されています。

参照先 len.

参照元 ndr_pull_string().

{
        size_t len;

        len = strnlen(src, n);
        if (len+1 <= n) {
                len += 1;
        }

        return len;
}

size_t utf16_len

(

const void *

buf

)

return the number of bytes occupied by a buffer in CH_UTF16 format the result includes the null termination

util_str.c の 2609 行で定義されています。

参照先 len.

{
        size_t len;

        for (len = 0; SVAL(buf,len); len += 2) ;

        return len + 2;
}

size_t utf16_len_n	(	const void *	src,
		size_t	n
	)

return the number of bytes occupied by a buffer in CH_UTF16 format the result includes the null termination limited by 'n' bytes

util_str.c の 2623 行で定義されています。

参照先 len.

参照元 ndr_pull_string().

{
        size_t len;

        for (len = 0; (len+2 < n) && SVAL(src, len); len += 2) ;

        if (len+2 <= n) {
                len += 2;
        }

        return len;
}

char* escape_shell_string

(

const char *

src

)

util_str.c の 2644 行で定義されています。

参照先 c・next_codepoint().

参照元 smbrun_internal().

{
        size_t srclen = strlen(src);
        char *ret = SMB_MALLOC((srclen * 2) + 1);
        char *dest = ret;
        BOOL in_s_quote = False;
        BOOL in_d_quote = False;
        BOOL next_escaped = False;

        if (!ret) {
                return NULL;
        }

        while (*src) {
                size_t c_size;
                codepoint_t c = next_codepoint(src, &c_size);

                if (c == INVALID_CODEPOINT) {
                        SAFE_FREE(ret);
                        return NULL;
                }

                if (c_size > 1) {
                        memcpy(dest, src, c_size);
                        src += c_size;
                        dest += c_size;
                        next_escaped = False;
                        continue;
                }

                /*
                 * Deal with backslash escaped state.
                 * This only lasts for one character.
                 */

                if (next_escaped) {
                        *dest++ = *src++;
                        next_escaped = False;
                        continue;
                }

                /*
                 * Deal with single quote state. The
                 * only thing we care about is exiting
                 * this state.
                 */

                if (in_s_quote) {
                        if (*src == '\'') {
                                in_s_quote = False;
                        }
                        *dest++ = *src++;
                        continue;
                }

                /* 
                 * Deal with double quote state. The most
                 * complex state. We must cope with \, meaning
                 * possibly escape next char (depending what it
                 * is), ", meaning exit this state, and possibly
                 * add an \ escape to any unprotected character
                 * (listed in INSIDE_DQUOTE_LIST).
                 */

                if (in_d_quote) {
                        if (*src == '\\') {
                                /* 
                                 * Next character might be escaped.
                                 * We have to peek. Inside double
                                 * quotes only INSIDE_DQUOTE_LIST
                                 * characters are escaped by a \.
                                 */

                                char nextchar;

                                c = next_codepoint(&src[1], &c_size);
                                if (c == INVALID_CODEPOINT) {
                                        SAFE_FREE(ret);
                                        return NULL;
                                }
                                if (c_size > 1) {
                                        /*
                                         * Don't escape the next char.
                                         * Just copy the \.
                                         */
                                        *dest++ = *src++;
                                        continue;
                                }

                                nextchar = src[1];

                                if (nextchar && strchr(INSIDE_DQUOTE_LIST, (int)nextchar)) {
                                        next_escaped = True;
                                }
                                *dest++ = *src++;
                                continue;
                        }

                        if (*src == '\"') {
                                /* Exit double quote state. */
                                in_d_quote = False;
                                *dest++ = *src++;
                                continue;
                        }

                        /*
                         * We know the character isn't \ or ",
                         * so escape it if it's any of the other
                         * possible unprotected characters.
                         */

                        if (strchr(INSIDE_DQUOTE_LIST, (int)*src)) {
                                *dest++ = '\\';
                        }
                        *dest++ = *src++;
                        continue;
                }

                /* 
                 * From here to the end of the loop we're
                 * not in the single or double quote state.
                 */

                if (*src == '\\') {
                        /* Next character must be escaped. */
                        next_escaped = True;
                        *dest++ = *src++;
                        continue;
                }

                if (*src == '\'') {
                        /* Go into single quote state. */
                        in_s_quote = True;
                        *dest++ = *src++;
                        continue;
                }

                if (*src == '\"') {
                        /* Go into double quote state. */
                        in_d_quote = True;
                        *dest++ = *src++;
                        continue;
                }

                /* Check if we need to escape the character. */

                if (!strchr(INCLUDE_LIST, (int)*src)) {
                        *dest++ = '\\';
                }
                *dest++ = *src++;
        }
        *dest++ = '\0';
        return ret;
}

---

変数

const char* last_ptr = NULL [static]

This is like next_token but is not re-entrant and "remembers" the first parameter so you can pass NULL.

This is useful for user interface code but beware the fact that it is not re-entrant!

util_str.c の 116 行で定義されています。

参照元 next_token_nr()・remove_from_freelist()・set_first_token()・tdb_allocate()・tdb_do_delete()・tdb_validate_freelist()・toktocliplist().

uint16 tmpbuf[sizeof(pstring)] [static]

util_str.c の 129 行で定義されています。

参照元 catia_string_replace()・push_ascii()・push_utf8()・strhaslower()・strhasupper()・wb_aix_getgrset().

const char* null_string = "" [static]

util_str.c の 926 行で定義されています。

参照元 cmd_fstat()・cmd_lstat()・cmd_stat()・string_free()・string_init().

const char* b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/" [static]

util_str.c の 2235 行で定義されています。

参照元 base64_decode_data_blob()・base64_encode_data_blob().

---