iPXE
netbios.c
Go to the documentation of this file.
00001 /*
00002  * Copyright (C) 2018 Michael Brown <mbrown@fensystems.co.uk>.
00003  *
00004  * This program is free software; you can redistribute it and/or
00005  * modify it under the terms of the GNU General Public License as
00006  * published by the Free Software Foundation; either version 2 of the
00007  * License, or any later version.
00008  *
00009  * This program is distributed in the hope that it will be useful, but
00010  * WITHOUT ANY WARRANTY; without even the implied warranty of
00011  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012  * General Public License for more details.
00013  *
00014  * You should have received a copy of the GNU General Public License
00015  * along with this program; if not, write to the Free Software
00016  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
00017  * 02110-1301, USA.
00018  *
00019  * You can also choose to distribute this program under the terms of
00020  * the Unmodified Binary Distribution Licence (as given in the file
00021  * COPYING.UBDL), provided that you have satisfied its requirements.
00022  */
00023 
00024 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
00025 
00026 /** @file
00027  *
00028  * NetBIOS user names
00029  *
00030  */
00031 
00032 #include <stddef.h>
00033 #include <string.h>
00034 #include <ipxe/netbios.h>
00035 
00036 /**
00037  * Split NetBIOS [domain\]username into separate domain and username fields
00038  *
00039  * @v username          NetBIOS [domain\]username string
00040  * @ret domain          Domain portion of string, or NULL if no domain present
00041  *
00042  * This function modifies the original string by removing the
00043  * separator.  The caller may restore the string using
00044  * netbios_domain_undo().
00045  */
00046 const char * netbios_domain ( char **username ) {
00047         char *domain_username = *username;
00048         char *sep;
00049 
00050         /* Find separator, if present */
00051         sep = strchr ( domain_username, '\\' );
00052         if ( ! sep )
00053                 return NULL;
00054 
00055         /* Overwrite separator with NUL terminator and update username string */
00056         *sep = '\0';
00057         *username = ( sep + 1 );
00058 
00059         return domain_username;
00060 }