ndmpd_util.c revision 8c4f9701439555b41fbfe7848508f53b52166007
8c4f9701439555b41fbfe7848508f53b52166007Janice Chang * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * BSD 3 Clause License
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Copyright (c) 2007, The Storage Networking Industry Association.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Redistribution and use in source and binary forms, with or without
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * modification, are permitted provided that the following conditions
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * - Redistributions of source code must retain the above copyright
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * notice, this list of conditions and the following disclaimer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * - Redistributions in binary form must reproduce the above copyright
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * notice, this list of conditions and the following disclaimer in
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * the documentation and/or other materials provided with the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * distribution.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * - Neither the name of The Storage Networking Industry Association (SNIA)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nor the names of its contributors may be used to endorse or promote
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * products derived from this software without specific prior written
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * permission.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * POSSIBILITY OF SUCH DAMAGE.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar/* Copyright (c) 2007, The Storage Networking Industry Association. */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar/* Copyright (c) 1996, 1997 PDC, Network Appliance. All Rights Reserved */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Mutex to protect Nlp
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Patchable socket buffer sizes in kilobytes.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ssb: send buffer size.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * rsb: receive buffer size.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Force to backup all the intermediate directories leading to an object
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * to be backed up in 'dump' format backup.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Force to backup all the intermediate directories leading to an object
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * to be backed up in 'tar' format backup.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Should the 'st_ctime' be ignored during incremental level backup?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Should the 'st_lmtime' be included during incremental level backup?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Force to send the file history node entries along with the file history
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dir entries for all directories containing the changed files to the client
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * for incremental backup.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Note: This variable is added to support Bakbone Software's Netvault DMA
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * which expects to get the FH ADD NODES for all upper directories which
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * contain the changed files in incremental backup along with the FH ADD DIRS.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Maximum permitted sequence number in the token-based backup. The
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * value of this variable can be changed by the administrator and is
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * saved in the NDMP configuration file.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Force backup directories in incremental backups. If the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * directory is not modified itself, it's not backed up by
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Keeps track of the open SCSI (including tape and robot) devices.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * When a SCSI device is opened its name must be added to this list and
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * when it's closed its name must be removed from this list. The main
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * purpose of this list is the robot device. If the robot devices are not
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * attached in SASD layer, Local Backup won't see them. If they are
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * attached and we open the robot devices, then wrong commands are sent
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * to robot by SASD since it assumes that the robot is a tape (sequential
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * access) device.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Head of the opened SCSI devices list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * List of things to be exluded from backup.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarstatic char *exls[] = {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NULL, /* reserved for a copy of the "backup.directory" */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * The counter for creating unique names with "ndmp.%d" format.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarstatic int ndmp_job_cnt = 0;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_add_file_handler
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Adds a file handler to the file handler list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * The file handler list is used by ndmpd_api_dispatch.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cookie (input) - opaque data to be passed to file hander when called.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fd (input) - file descriptor.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * mode (input) - bitmask of the following:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 1 = watch file for ready for reading
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 2 = watch file for ready for writing
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 4 = watch file for exception
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * class (input) - handler class. (HC_CLIENT, HC_MOVER, HC_MODULE)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * func (input) - function to call when the file meets one of the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * conditions specified by mode.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0 - success.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1 - error.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_add_file_handler(ndmpd_session_t *session, void *cookie, int fd,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ulong_t mode, ulong_t class, ndmpd_file_handler_func_t *func)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar new = ndmp_malloc(sizeof (ndmpd_file_handler_t));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_remove_file_handler
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Removes a file handler from the file handler list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fd (input) - file descriptor.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0 - success.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1 - error.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_remove_file_handler(ndmpd_session_t *session, int fd)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar while (*last != 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_connection_closed
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * If the connection closed or not.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fd (input) : file descriptor
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0 - connection is still valid
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 1 - connection is not valid anymore
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1 - Internal kernel error
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ret = select(FD_SETSIZE, &fds, NULL, NULL, &timeout);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_check_mover_state
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Checks the mover connection status and sends an appropriate
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * NDMP message to client based on that.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_session_t *session (input) : session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * NDMPV3 Spec (Three-way restore):
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Once all of the files have been recovered, NDMP DATA Server closes
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * the connection to the mover on the NDMP TAPE Server. THEN
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * The NDMP client should receive an NDMP_NOTIFY_MOVER_HALTED message
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * with an NDMP_MOVER_CONNECT_CLOSED reason from the NDMP TAPE Server
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* If connection is closed by the peer */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_mover.md_mode == NDMP_MOVER_MODE_WRITE) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* Connection closed or internal error */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "ndmp mover: connection closed by peer");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "ndmp mover: Internal error");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_select
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Calls select on the the set of file descriptors from the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * file handler list masked by the fd_class argument.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Calls the file handler function for each
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * file descriptor that is ready for I/O.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * block (input) - if TRUE, ndmpd_select waits until at least one
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * file descriptor is ready for I/O. Otherwise,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * it returns immediately if no file descriptors are
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ready for I/O.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * class_mask (input) - bit mask of handler classes to be examined.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Provides for excluding some of the handlers from
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * being called.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1 - error.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0 - no handlers were called.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 1 - at least one handler was called.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_select(ndmpd_session_t *session, boolean_t block, ulong_t class_mask)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * If select should be blocked, then we poll every ten seconds.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * The reason is in case of three-way restore we should be able
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * to detect if the other end closed the connection or not.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * NDMP client(DMA) does not send any information about the connection
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * that was closed in the other end.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* Create the fd_sets for select. */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (handler = session->ns_file_handler_list; handler != 0;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_EXCEPTION)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar n = select(FD_SETSIZE, &rfds, &wfds, &efds, &timeout);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (n < 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar int connection_fd = ndmp_get_fd(session->ns_connection);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (handler = session->ns_file_handler_list; handler != 0;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_READ) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_WRITE) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_EXCEPTION) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar while (handler != 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_READ) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_WRITE) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (handler->fh_mode & NDMPD_SELECT_MODE_EXCEPTION) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * K.L. The list can be modified during the execution
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * of handler->fh_func. Therefore, handler will start
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * from the beginning of the handler list after
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * each execution.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Release the thread which is waiting for a request
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * to be proccessed.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_save_env
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Saves a copy of the environment variable list from the data_start_backup
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * request or data_start_recover request.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * env (input) - environment variable list to be saved.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * envlen (input) - length of variable array.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * error code.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_save_env(ndmpd_session_t *session, ndmp_pval *env, ulong_t envlen)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_data.dd_env = ndmp_malloc(sizeof (ndmp_pval) * envlen);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < envlen; i++) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_free_env
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Free the previously saved environment variable array.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session - NDMP session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < count; i++) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_save_nlist_v2
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Save a copy of list of file names to be restored.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlist (input) - name list from data_start_recover request.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlistlen (input) - length of name list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * array of file name pointers.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * free_nlist should be called to free the returned list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * A null pointer indicates the end of the list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_save_nlist_v2(ndmpd_session_t *session, ndmp_name *nlist,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_data.dd_nlist = ndmp_malloc(sizeof (ndmp_name)*nlistlen);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < nlistlen; i++) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar namebuf = ndmp_malloc(strlen(nlist[i].name) + 1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar destbuf = ndmp_malloc(strlen(nlist[i].dest) + 1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_data.dd_nlist[i].ssid = nlist[i].ssid;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_data.dd_nlist[i].fh_info = nlist[i].fh_info;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_free_nlist_v2
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Free a list created by ndmpd_save_nlist_v2.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < session->ns_data.dd_nlist_len; i++) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_free_nlist_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Free a list created by ndmpd_save_nlist_v3.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < session->ns_data.dd_nlist_len; tp++, i++) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_save_nlist_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Save a copy of list of file names to be restored.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlist (input) - name list from data_start_recover request.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlistlen (input) - length of name list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * array of file name pointers.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * free_nlist should be called to free the returned list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * A null pointer indicates the end of the list.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_save_nlist_v3(ndmpd_session_t *session, ndmp_name_v3 *nlist,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_malloc(sizeof (mem_ndmp_name_v3_t) * nlistlen);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* In V4 destination dir cannot be NULL */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } else if (!(tp->nm3_dpath = strdup(sp->destination_dir))) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar else if (!(tp->nm3_newnm = strdup(sp->new_name))) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar tp->nm3_fh_info = quad_to_long_long(sp->fh_info);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "orig \"%s\"", tp->nm3_opath);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "dest \"%s\"", NDMP_SVAL(tp->nm3_dpath));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "name \"%s\"", NDMP_SVAL(tp->nm3_newnm));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "fh_info %lld", tp->nm3_fh_info);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_free_nlist
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Free the recovery list based on the version
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Comparison function used in sorting the Nlist based on their
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * file history info (offset of the entry on the tape)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * p (input) - pointer to P
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * q (input) - pointer to Q
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarfh_cmpv3(const void *p,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar const void *q)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar#define FH_INFOV3(p) (((mem_ndmp_name_v3_t *)p)->nm3_fh_info)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_sort_nlist_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Sort the recovery list based on their offset on the tape
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (!session || session->ns_data.dd_nlist_len == 0 ||
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_send_reply
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Send the reply, check for error and print the msg if any error
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * occured when sending the reply.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * connection (input) - connection pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_send_reply(ndmp_connection_t *connection, void *reply, char *msg)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (ndmp_send_response(connection, NDMP_NO_ERR, reply) < 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_mtioctl
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Performs numerous filemark operations.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fd - file descriptor of the device
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cmd - filemark or record command
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * count - the number of operations to be performed
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_ERR, "Failed to send command to tape: %m.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * quad_to_long_long
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Convert type quad to longlong_t
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * long_long_to_quad
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Convert long long to quad type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_set_socket_nodelay
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Set the TCP socket option to nodelay mode
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) setsockopt(sock, IPPROTO_TCP, TCP_NODELAY, &flag, sizeof (flag));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_set_socket_snd_buf
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Set the socket send buffer size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (setsockopt(sock, SOL_SOCKET, SO_SNDBUF, &size, sizeof (size)) < 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "SO_SNDBUF failed errno=%d", errno);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_set_socket_rcv_buf
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Set the socket receive buffer size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (setsockopt(sock, SOL_SOCKET, SO_RCVBUF, &size, sizeof (size)) < 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "SO_RCVBUF failed errno=%d", errno);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_get_max_tok_seq
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get the maximum permitted token sequence for token-based
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_max_tok_seq
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_buffer_get_size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Return the NDMP transfer buffer size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * buffer size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (session->ns_data.dd_mover.addr_type == NDMP_ADDR_TCP) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar xfer_size = atoi(ndmpd_get_prop_default(NDMP_MOVER_RECSIZE,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Remote operation: %d", xfer_size);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "Local operation: %lu", session->ns_mover.md_record_size);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if ((xfer_size = session->ns_mover.md_record_size) == 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "xfer_size: %d", xfer_size);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_lbr_init
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Initialize the LBR/NDMP backup parameters
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0: on success
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1: otherwise
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "ndmp_lbr_params already allocated.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_ndmp_lbr_params = ndmp_malloc(sizeof (ndmp_lbr_params_t));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar session->ns_ndmp_lbr_params->nlp_session = session;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) cond_init(&session->ns_ndmp_lbr_params->nlp_cv, 0, NULL);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_lbr_cleanup
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Deallocate and cleanup all NDMP/LBR parameters
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0: on success
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1: otherwise
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * If in 3-way restore, the connection close is detected after
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * check in tape_read(), the reader thread of mover may wait forever
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * for the tape to be changed. Force the reader thread to exit.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (session->ns_ndmp_lbr_params->nlp_bkmap != -1)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) dbm_free(session->ns_ndmp_lbr_params->nlp_bkmap);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar tlm_release_list(session->ns_ndmp_lbr_params->nlp_exl);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar tlm_release_list(session->ns_ndmp_lbr_params->nlp_inc);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) cond_destroy(&session->ns_ndmp_lbr_params->nlp_cv);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_ref_nw
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Increase the references to the NDMP/LBR parameter to prevent
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * unwanted release
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_unref_nw
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Decrease the references to the NDMP/LBR parameter before
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_wait_nw
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Wait for a NDMP/LBR parameter to get available
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_event_nw
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Signal that a NDMP/LBR parameter is available to wake up the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * threads waiting on that
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_event_rv_get
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get the return value for each NLP
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * return value
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * nlp_event_rv_set
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Set the return value for an NLP
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * rv (input) - return value
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * is_buffer_erroneous
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Run a sanity check on the buffer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * TRUE: if the buffer seems to have error
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * FALSE: if the buffer is full and has valid data.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar rv = (buf == NULL || buf->tb_eot || buf->tb_eof ||
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "eot: %u, eof: %u, errno: %d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_execute_cdb
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Main SCSI CDB execution program, this is used by message handler
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * for the NDMP tape/SCSI execute CDB requests. This function uses
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * USCSI interface to run the CDB command and sets all the CDB parameters
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * in the SCSI query before calling the USCSI ioctl. The result of the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * CDB is returned in two places:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cmd.uscsi_status The status of CDB execution
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cmd.uscsi_rqstatus The status of sense requests
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * reply.error The general errno (ioctl)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * adapter_name (input) - name of SCSI adapter
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * sid (input) - SCSI target ID
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * lun (input) - LUN number
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * request (input) - NDMP client CDB request
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_execute_cdb(ndmpd_session_t *session, char *adapter_name, int sid, int lun,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) memset((void *)&reply, 0, sizeof (reply));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) memset((void *)rq_buf, 0, sizeof (rq_buf));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar " scsi_execute_cdb reply.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } else if (request->flags == NDMP_SCSI_DATA_OUT) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar cmd.uscsi_bufaddr = request->dataout.dataout_val;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar cmd.uscsi_buflen = request->dataout.dataout_len;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "cmd: 0x%x, len: %d, flags: %d, datain_len: %d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar request->cdb.cdb_val[0] & 0xff, request->cdb.cdb_len,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "dataout_len: %d, timeout: %d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar request->dataout.dataout_len, request->timeout);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_send_reply(session->ns_connection, (void *) &reply,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "sending execute_cdb reply");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if ((olp = ndmp_open_list_find(adapter_name, sid, lun)) != NULL) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_send_reply(session->ns_connection, (void *) &reply,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "sending execute_cdb reply");
674cb4b09c0706bc1cb658e79f39997d43bad8a0Reza Sabdar "Failed to send command to device: %m");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "ioctl(USCSICMD) error: %m");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar reply.dataout_len = request->dataout.dataout_len;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar reply.ext_sense.ext_sense_len = cmd.uscsi_rqlen - cmd.uscsi_rqresid;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (ndmp_send_response(session->ns_connection, NDMP_NO_ERR,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void *)&reply) < 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Error sending scsi_execute_cdb reply.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_stop_local_reader
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Stops a mover reader thread (for local backup only)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cmds (input) - reader/writer command struct
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_stop_local_reader(ndmpd_session_t *session, tlm_commands_t *cmds)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 2-way restore.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (cmds != NULL && cmds->tcs_reader_count > 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Stops a mover reader thread (for remote backup only)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * cmds (input) - reader/writer command struct
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_stop_remote_reader(ndmpd_session_t *session)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 3-way restore.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_wait_for_reader
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Wait for a reader until get done (busy wait)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_open_list_find
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Find a specific device in the open list
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dev (input) - device name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * sid (input) - SCSI target ID
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * lun (input) - LUN number
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * pointer to the open list entry
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (olp = LIST_FIRST(olhp); olp != NULL; olp = LIST_NEXT(olp, ol_q))
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (strcmp(olp->ol_devnm, dev) == 0 && olp->ol_sid == sid &&
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_open_list_add
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Add a specific device to the open list
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * conn (input) - connection pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dev (input) - device name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * sid (input) - SCSI target ID
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * lun (input) - LUN number
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fd (input) - the device file descriptor
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_open_list_add(ndmp_connection_t *conn, char *dev, int sid, int lun, int fd)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "conn: 0x%08x, dev: %s, sid: %d, lun: %d", conn, dev, sid, lun);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if ((olp = ndmp_open_list_find(dev, sid, lun)) != NULL) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * The adapter handle can be opened many times by the clients.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Only when the target is set, we must check and reject the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * open request if the device is already being used by another
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } else if ((olp = ndmp_malloc(sizeof (struct open_list))) == NULL) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } else if ((olp->ol_devnm = strdup(dev)) == NULL) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_open_list_del
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Delete a specific device from the open list
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dev (input) - device name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * sid (input) - SCSI target ID
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * lun (input) - LUN number
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if ((olp = ndmp_open_list_find(dev, sid, lun)) == NULL) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "Removed dev: %s, sid: %d, lun: %d", dev, sid, lun);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_open_list_release
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Close all the resources belonging to this connection.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_connection_t *conn : connection identifier
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "olp->conn 0x%08x", olp->cl_conn);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "Removed dev: %s, sid: %d, lun: %d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_stop_buffer_worker
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Stop all reader and writer threads for a specific buffer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_stop_buffer_worker(ndmpd_session_t *session)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "cmds->tcs_command == NULL");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar cmds->tcs_reader = cmds->tcs_writer = TLM_ABORT;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "trying to stop buffer worker");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_stop_reader_thread
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Stop only the reader threads of a specific buffer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_stop_reader_thread(ndmpd_session_t *session)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "cmds->tcs_command == NULL");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "trying to stop reader thread");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_stop_reader_thread
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Stop only the writer threads of a specific buffer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_stop_writer_thread(ndmpd_session_t *session)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "cmds->tcs_command == NULL");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "trying to stop writer thread");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_free_reader_writer_ipc
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Free and release the reader/writer buffers and the IPC structure
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * for reader and writer threads.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_free_reader_writer_ipc(ndmpd_session_t *session)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "cmds->tcs_command->tc_ref: %d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar tlm_release_reader_writer_ipc(cmds->tcs_command);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_waitfor_op
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Wait for a session reference count to drop to zero
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "waiting for session nref: %d", session->ns_nref);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_session_ref
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Increment the reference count of the session
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_session_unref
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Decrement the reference count of the session
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_addr2str_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Convert the address type to a string
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * type (input) - address type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * type in string
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_valid_v3addr_type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Make sure that the NDMP address is from any of the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * valid types
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * type (input) - address type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0: invalid
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_copy_addr_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Copy NDMP address from source to destination (V2 and V3 only)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dst (ouput) - destination address
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * src (input) - source address
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_copy_addr_v3(ndmp_addr_v3 *dst, ndmp_addr_v3 *src)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* nothing */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_copy_addr_v4
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Copy NDMP address from source to destination. V4 has a extra
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * environment list inside the address too which needs to be copied.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * dst (ouput) - destination address
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * src (input) - source address
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_copy_addr_v4(ndmp_addr_v4 *dst, ndmp_addr_v4 *src)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* nothing */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar dst->tcp_addr_v4 = ndmp_malloc(sizeof (ndmp_tcp_addr_v4) *
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar dst->tcp_env_v4(i).addr_env_len = 0; /* Solaris */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar dst->tcp_env_v4(i).addr_env_val = 0; /* Solaris */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_connect_sock_v3
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Creates a socket and connects to the specified address/port
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * addr (input) - IP address
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * port (input) - port number
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0: on success
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1: otherwise
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_connect_sock_v3(ulong_t addr, ushort_t port)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "addr %s:%d", inet_ntoa(IN_ADDR(addr)), port);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (connect(sock, (struct sockaddr *)&sin, sizeof (sin)) < 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_set_socket_snd_buf(sock, ndmp_sbs*KILOBYTE);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_set_socket_rcv_buf(sock, ndmp_rbs*KILOBYTE);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) setsockopt(sock, SOL_SOCKET, SO_KEEPALIVE, &flag,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_create_socket
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Creates a socket for listening for accepting data connections.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session (input) - session pointer.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * addr (output) - location to store address of socket.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * port (output) - location to store port of socket.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * 0 - success.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * -1 - error.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_create_socket(ulong_t *addr, ushort_t *port)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (!p || *p == 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_ERR, "Undetermined network port.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (bind(sd, (struct sockaddr *)&sin, sizeof (sin)) < 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } else if (getsockname(sd, (struct sockaddr *)&sin, &length) < 0) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Convert the specified time into a string. It's like
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ctime(), but:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * - chops the trailing '\n' of ctime.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * - and returns "the epoch" if time is 0.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * "": invalid argument.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * "the epoch": if time is 0.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * string format of the time.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return ("");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (*t == (time_t)0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return ("the epoch");
89f9eb8701145fa396cfc2ac0b468bd5c8466494Reza Sabdar return ("");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_new_job_name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Create a job name for each backup/restore to keep track
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * jname (output) - job name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) snprintf(jname, TLM_MAX_BACKUP_JOB_NAME, "%s%d",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fs_is_valid_logvol
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Check if the log path exists
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * path (input) - log path
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * FALSE: invalid
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * TRUE: valid
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_mk_temp
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Make a temporary file using the working directory path and the
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * buf (output) - the temporary file name path
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar const char *dir;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "NDMP work path not specified");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "Log file path cannot be on system volumes.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "NDMP work path not specified");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_make_bk_dir_path
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Make a directory path for temporary files under the NDMP
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * working directory.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * buf (output) - result path
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * fname (input) - the file name
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar const char *p;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (p == NULL || *p == '\0' || !fs_is_valid_logvol((char *)p)) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_is_chkpnt_root
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Is this a root checkpoint (snapshot) directory.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Note: a temporary function
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Couldn't stat path \"%s\"", path);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_make_exc_list
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Make a list of files that should not be backed up.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameters:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * list - array of character strings
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar n = sizeof (exls);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * If ndmpd_get_prop returns NULL, the array will be
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * null-terminated.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_get_bk_dir_ino
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get the inode number of the backup directory
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Getting inode # of \"%s\"",
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_check_utf8magic
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Check if the magic string for exists in the tar header. This
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * magic string (which also indicates that the file names are in
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * UTF8 format) is used as a crest to indetify our own tapes.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * This checking is always done before all restores except DAR
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* wait until the first buffer gets full. */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar cp = tlm_get_read_buffer(RECORDSIZE, &err, cmd->tc_buffers,
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Can't read from buffers, err: %d", err);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Not enough data in the buffers");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return ((strncmp(cp, NDMPUTF8MAGIC, len) == 0) ? TRUE : FALSE);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_get_cur_bk_time
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get the backup checkpoint time.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_get_cur_bk_time(ndmp_lbr_params_t *nlp, time_t *tp, char *jname)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (-1);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (!fs_is_chkpnt_enabled(nlp->nlp_backup_path)) {
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar err = tlm_get_chkpnt_time(nlp->nlp_backup_path, !NLP_ISCHKPNTED(nlp),
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * get_relative_path
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_get_relative_path(char *base, char *fullpath)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if (*p == '/')
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_get_nlp
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get NDMP local backup parameters
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameter:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * session cooke
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * LBR structure
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar return (((ndmpd_session_t *)cookie)->ns_ndmp_lbr_params);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * is_tape_unit_ready
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Check if the tape device is ready or not
295e611f647a9229cb7b346b6febc77618b605c4Reza Sabdar if ((fd = open(adptnm, O_RDONLY | O_NDELAY)) < 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar } while (--try > 0);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * scsi_test_unit_ready
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * This is for Test Unit Read, without this function, the only
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * impact is getting EBUSY's before each operation which we have
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * busy waiting loops checking EBUSY error code.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) memset(&ucmd, 0, sizeof (struct uscsi_cmd));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar (void) memset(&cdb, 0, sizeof (union scsi_cdb));
c211fc479225fa54805cf480633bf6689ca9a2dbReza Sabdar ucmd.uscsi_timeout = 60; /* Allow maximum 1 min */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar "Failed to send inquiry request to device: %m.");
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar NDMP_LOG(LOG_DEBUG, "Inquiry request failed for"
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmp_load_params
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Load the parameters.
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameter:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_dump_path_node = ndmpd_get_prop_yorn(NDMP_DUMP_PATHNODE_ENV) ?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_tar_path_node = ndmpd_get_prop_yorn(NDMP_TAR_PATHNODE_ENV) ?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmpd_get_prop_yorn(NDMP_IGNCTIME_ENV) ? TRUE : FALSE;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_include_lmtime = ndmpd_get_prop_yorn(NDMP_INCLMTIME_ENV) ?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_max_tok_seq = atoi(ndmpd_get_prop_default(NDMP_MAXSEQ_ENV, "9"));
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_full_restore_path = ndmpd_get_prop_yorn(NDMP_FULL_RESTORE_PATH) ?
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_fhinode = ndmpd_get_prop_yorn(NDMP_FHIST_INCR_ENV) ? TRUE : FALSE;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* Get the value from ndmp SMF property. */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar ndmp_dar_support = ndmpd_get_prop_yorn(NDMP_DAR_SUPPORT);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar if ((ndmp_ver = atoi(ndmpd_get_prop(NDMP_VERSION_ENV))) == 0)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Randomize the contents of a buffer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameter:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * buffer (output) - destination buffer
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * size (input) - buffer size
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar /* LINTED improper alignment */
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar unsigned int *p = (unsigned int *)buffer;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar unsigned int dwlen = size / sizeof (unsigned int);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar unsigned int remlen = size % sizeof (unsigned int);
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar unsigned int tmp;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar unsigned int i;
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar for (i = 0; i < dwlen; i++)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ndmpd_get_file_entry_type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Converts the mode to the NDMP file type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Parameter:
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * mode (input) - file mode
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * ftype (output) - file type
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmpd_get_file_entry_type(int mode, ndmp_file_type *ftype)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Set a private data in the plugin context
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdarndmp_context_set_specific(ndmp_context_t *nctx, void *ptr)
2654012f83cec5dc15b61dfe3e4a4915f186e7a6Reza Sabdar * Get a private data in the plugin context