1 /*****************************************************************************
2 * telnet.c: VLM interface plugin
3 *****************************************************************************
4 * Copyright (C) 2000-2006 the VideoLAN team
7 * Authors: Simon Latapie <garf@videolan.org>
8 * Laurent Aimar <fenrir@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 /*****************************************************************************
27 *****************************************************************************/
33 #include <vlc_common.h>
34 #include <vlc_plugin.h>
35 #include <vlc_interface.h>
36 #include <vlc_input.h>
44 #ifdef HAVE_SYS_TIME_H
45 # include <sys/time.h>
55 #include <vlc_network.h>
59 #define READ_MODE_PWD 1
60 #define READ_MODE_CMD 2
61 #define WRITE_MODE_PWD 3 // when we write the word "Password:"
62 #define WRITE_MODE_CMD 4
72 /*****************************************************************************
74 *****************************************************************************/
75 static int Open ( vlc_object_t * );
76 static void Close( vlc_object_t * );
78 #define TELNETHOST_TEXT N_( "Host" )
79 #define TELNETHOST_LONGTEXT N_( "This is the host on which the " \
80 "interface will listen. It defaults to all network interfaces (0.0.0.0)." \
81 " If you want this interface to be available only on the local " \
82 "machine, enter \"127.0.0.1\"." )
83 #define TELNETPORT_TEXT N_( "Port" )
84 #define TELNETPORT_LONGTEXT N_( "This is the TCP port on which this " \
85 "interface will listen. It defaults to 4212." )
86 #define TELNETPORT_DEFAULT 4212
87 #define TELNETPWD_TEXT N_( "Password" )
88 #define TELNETPWD_LONGTEXT N_( "A single administration password is used " \
89 "to protect this interface. The default value is \"admin\"." )
90 #define TELNETPWD_DEFAULT "admin"
93 set_shortname( "Telnet" );
94 set_category( CAT_INTERFACE );
95 set_subcategory( SUBCAT_INTERFACE_CONTROL );
96 add_string( "telnet-host", "", NULL, TELNETHOST_TEXT,
97 TELNETHOST_LONGTEXT, true );
98 add_integer( "telnet-port", TELNETPORT_DEFAULT, NULL, TELNETPORT_TEXT,
99 TELNETPORT_LONGTEXT, true );
100 add_password( "telnet-password", TELNETPWD_DEFAULT, NULL, TELNETPWD_TEXT,
101 TELNETPWD_LONGTEXT, true );
102 set_description( N_("VLM remote control interface") );
103 add_category_hint( "VLM", NULL, false );
104 set_capability( "interface", 0 );
105 set_callbacks( Open , Close );
108 /*****************************************************************************
110 *****************************************************************************/
111 static void Run( intf_thread_t * );
115 int i_mode; /* read or write */
117 char buffer_read[1000]; // 1000 byte per command should be sufficient
120 char *p_buffer_write; // the position in the buffer
121 int i_buffer_write; // the number of byte we still have to send
122 int i_tel_cmd; // for specific telnet commands
126 static char *MessageToString( vlm_message_t *, int );
127 static void Write_message( telnet_client_t *, vlm_message_t *, const char *, int );
131 telnet_client_t **clients;
138 * getPort: Decide which port to use. There are two possibilities to
139 * specify a port: integrated in the --telnet-host option with :PORT
140 * or using the --telnet-port option. The --telnet-port option has
142 * This code relies upon the fact the url.i_port is 0 if the :PORT
143 * option is missing from --telnet-host.
145 static int getPort(intf_thread_t *p_intf, const vlc_url_t *url, int i_port)
147 if (i_port == TELNETPORT_DEFAULT && url->i_port != 0)
148 i_port = url->i_port;
149 if (url->i_port != 0 && url->i_port != i_port)
150 // Print error if two different ports have been specified
151 msg_Warn( p_intf, "ignoring port %d (using %d)", url->i_port, i_port );
155 /*****************************************************************************
156 * Open: initialize dummy interface
157 *****************************************************************************/
158 static int Open( vlc_object_t *p_this )
160 intf_thread_t *p_intf = (intf_thread_t*) p_this;
166 if( !(mediatheque = vlm_New( p_intf )) )
168 msg_Err( p_intf, "cannot start VLM" );
172 msg_Info( p_intf, "using the VLM interface plugin..." );
174 i_telnetport = config_GetInt( p_intf, "telnet-port" );
175 psz_address = config_GetPsz( p_intf, "telnet-host" );
177 vlc_UrlParse(&url, psz_address, 0);
180 // There might be two ports given, resolve any potentially
182 url.i_port = getPort(p_intf, &url, i_telnetport);
184 p_intf->p_sys = malloc( sizeof( intf_sys_t ) );
187 vlm_Delete( mediatheque );
188 vlc_UrlClean( &url );
191 if( ( p_intf->p_sys->pi_fd = net_ListenTCP( p_intf, url.psz_host, url.i_port ) ) == NULL )
193 msg_Err( p_intf, "cannot listen for telnet" );
194 vlm_Delete( mediatheque );
195 vlc_UrlClean( &url );
196 free( p_intf->p_sys );
200 "telnet interface started on interface %s %d",
201 url.psz_host, url.i_port );
203 p_intf->p_sys->i_clients = 0;
204 p_intf->p_sys->clients = NULL;
205 p_intf->p_sys->mediatheque = mediatheque;
206 p_intf->pf_run = Run;
208 vlc_UrlClean( &url );
212 /*****************************************************************************
214 *****************************************************************************/
215 static void Close( vlc_object_t *p_this )
217 intf_thread_t *p_intf = (intf_thread_t*)p_this;
218 intf_sys_t *p_sys = p_intf->p_sys;
221 for( i = 0; i < p_sys->i_clients; i++ )
223 telnet_client_t *cl = p_sys->clients[i];
225 free( cl->buffer_write );
228 free( p_sys->clients );
230 net_ListenClose( p_sys->pi_fd );
232 vlm_Delete( p_sys->mediatheque );
237 /*****************************************************************************
239 *****************************************************************************/
240 static void Run( intf_thread_t *p_intf )
242 intf_sys_t *p_sys = p_intf->p_sys;
244 unsigned nlisten = 0;
246 for (const int *pfd = p_sys->pi_fd; *pfd != -1; pfd++)
247 nlisten++; /* How many listening sockets do we have? */
249 psz_password = config_GetPsz( p_intf, "telnet-password" );
251 while( !intf_ShouldDie( p_intf ) )
253 unsigned ncli = p_sys->i_clients;
254 struct pollfd ufd[ncli + nlisten];
256 for (unsigned i = 0; i < ncli; i++)
258 telnet_client_t *cl = p_sys->clients[i];
261 if( (cl->i_mode == WRITE_MODE_PWD) || (cl->i_mode == WRITE_MODE_CMD) )
262 ufd[i].events = POLLOUT;
264 ufd[i].events = POLLIN;
268 for (unsigned i = 0; i < nlisten; i++)
270 ufd[ncli + i].fd = p_sys->pi_fd[i];
271 ufd[ncli + i].events = POLLIN;
272 ufd[ncli + i].revents = 0;
275 /* FIXME: arbitrary tick */
276 switch (poll (ufd, sizeof (ufd) / sizeof (ufd[0]), 500))
279 if (net_errno != EINTR)
281 msg_Err (p_intf, "network poll error");
289 /* check if there is something to do with the socket */
290 for (unsigned i = 0; i < ncli; i++)
292 telnet_client_t *cl = p_sys->clients[i];
294 if (ufd[i].revents & (POLLERR|POLLHUP))
298 TAB_REMOVE( p_intf->p_sys->i_clients ,
299 p_intf->p_sys->clients , cl );
304 if (ufd[i].revents & POLLOUT && (cl->i_buffer_write > 0))
308 i_len = send( cl->fd, cl->p_buffer_write ,
309 cl->i_buffer_write, 0 );
312 cl->p_buffer_write += i_len;
313 cl->i_buffer_write -= i_len;
316 if (ufd[i].revents & POLLIN)
321 while( ((i_recv=recv( cl->fd, cl->p_buffer_read, 1, 0 )) > 0) &&
322 ((cl->p_buffer_read - cl->buffer_read) < 999) )
324 switch( cl->i_tel_cmd )
327 switch( *(uint8_t *)cl->p_buffer_read )
332 *cl->p_buffer_read = '\n';
335 case TEL_IAC: // telnet specific command
345 switch( *(uint8_t *)cl->p_buffer_read )
347 case TEL_WILL: case TEL_WONT:
348 case TEL_DO: case TEL_DONT:
360 cl->p_buffer_read -= 2;
367 if( (cl->p_buffer_read - cl->buffer_read) == 999 )
369 Write_message( cl, NULL, "Line too long\r\n",
373 if (i_recv <= 0 && ( end || errno != EAGAIN ) )
378 /* and now we should bidouille the data we received / send */
379 for(int i = 0 ; i < p_sys->i_clients ; i++ )
381 telnet_client_t *cl = p_sys->clients[i];
383 if( cl->i_mode >= WRITE_MODE_PWD && cl->i_buffer_write == 0 )
385 // we have finished to send
386 cl->i_mode -= 2; // corresponding READ MODE
388 else if( cl->i_mode == READ_MODE_PWD &&
389 *cl->p_buffer_read == '\n' )
391 *cl->p_buffer_read = '\0';
392 if( !psz_password || !strcmp( psz_password, cl->buffer_read ) )
394 Write_message( cl, NULL, "\xff\xfc\x01\r\nWelcome, "
395 "Master\r\n> ", WRITE_MODE_CMD );
400 Write_message( cl, NULL,
401 "\r\nWrong password.\r\nPassword: ",
405 else if( cl->i_mode == READ_MODE_CMD &&
406 *cl->p_buffer_read == '\n' )
408 /* ok, here is a command line */
409 if( !strncmp( cl->buffer_read, "logout", 6 ) ||
410 !strncmp( cl->buffer_read, "quit", 4 ) ||
411 !strncmp( cl->buffer_read, "exit", 4 ) )
414 TAB_REMOVE( p_intf->p_sys->i_clients ,
415 p_intf->p_sys->clients , cl );
416 free( cl->buffer_write );
419 else if( !strncmp( cl->buffer_read, "shutdown", 8 ) )
421 msg_Err( p_intf, "shutdown requested" );
422 vlc_object_kill( p_intf->p_libvlc );
424 else if( *cl->buffer_read == '@'
425 && strchr( cl->buffer_read, ' ' ) )
427 /* Module specific commands (use same syntax as in the
429 char *psz_name = cl->buffer_read + 1;
430 char *psz_cmd, *psz_arg, *psz_msg;
433 psz_cmd = strchr( cl->buffer_read, ' ' );
434 *psz_cmd = '\0'; psz_cmd++;
435 if( ( psz_arg = strchr( psz_cmd, '\n' ) ) ) *psz_arg = '\0';
436 if( ( psz_arg = strchr( psz_cmd, '\r' ) ) ) *psz_arg = '\0';
437 if( ( psz_arg = strchr( psz_cmd, ' ' ) )
444 i_ret = var_Command( p_intf, psz_name, psz_cmd, psz_arg,
449 vlm_message_t *message;
450 message = vlm_MessageNew( "Module command", psz_msg );
451 Write_message( cl, message, NULL, WRITE_MODE_CMD );
452 vlm_MessageDelete( message );
458 vlm_message_t *message;
460 /* create a standard string */
461 *cl->p_buffer_read = '\0';
463 vlm_ExecuteCommand( p_sys->mediatheque, cl->buffer_read,
465 if( !strncmp( cl->buffer_read, "help", 4 ) )
467 vlm_message_t *p_my_help =
468 vlm_MessageNew( "Telnet Specific Commands:", NULL );
469 vlm_MessageAdd( p_my_help,
470 vlm_MessageNew( "logout, quit, exit" , NULL ) );
471 vlm_MessageAdd( p_my_help,
472 vlm_MessageNew( "shutdown" , NULL ) );
473 vlm_MessageAdd( p_my_help,
474 vlm_MessageNew( "@moduleinstance command argument",
476 vlm_MessageAdd( message, p_my_help );
478 Write_message( cl, message, NULL, WRITE_MODE_CMD );
479 vlm_MessageDelete( message );
484 /* handle new connections */
485 for (unsigned i = 0; i < nlisten; i++)
489 if (ufd[ncli + i].revents == 0)
492 fd = net_AcceptSingle (VLC_OBJECT(p_intf), ufd[ncli + i].fd);
496 telnet_client_t *cl = malloc( sizeof( telnet_client_t ));
503 memset( cl, 0, sizeof(telnet_client_t) );
506 cl->buffer_write = NULL;
507 cl->p_buffer_write = cl->buffer_write;
508 Write_message( cl, NULL,
509 "Password: \xff\xfb\x01" , WRITE_MODE_PWD );
510 TAB_APPEND( p_sys->i_clients, p_sys->clients, cl );
513 free( psz_password );
516 static void Write_message( telnet_client_t *client, vlm_message_t *message,
517 const char *string_message, int i_mode )
521 client->p_buffer_read = client->buffer_read;
522 (client->p_buffer_read)[0] = 0; // if (cl->p_buffer_read)[0] = '\n'
523 free( client->buffer_write );
525 /* generate the psz_message string */
528 /* ok, look for vlm_message_t */
529 psz_message = MessageToString( message, 0 );
533 /* it is a basic string_message */
534 psz_message = strdup( string_message );
537 client->buffer_write = client->p_buffer_write = psz_message;
538 client->i_buffer_write = strlen( psz_message );
539 client->i_mode = i_mode;
542 /* We need the level of the message to put a beautiful indentation.
543 * first level is 0 */
544 static char *MessageToString( vlm_message_t *message, int i_level )
546 #define STRING_CR "\r\n"
547 #define STRING_TAIL "> "
550 int i, i_message = sizeof( STRING_TAIL );
552 if( !message || !message->psz_name )
554 return strdup( STRING_CR STRING_TAIL );
556 else if( !i_level && !message->i_child && !message->psz_value )
558 /* A command is successful. Don't write anything */
559 return strdup( /*STRING_CR*/ STRING_TAIL );
562 i_message += strlen( message->psz_name ) + i_level * sizeof( " " ) + 1;
563 psz_message = malloc( i_message );
565 for( i = 0; i < i_level; i++ ) strcat( psz_message, " " );
566 strcat( psz_message, message->psz_name );
568 if( message->psz_value )
570 i_message += sizeof( " : " ) + strlen( message->psz_value ) +
572 psz_message = realloc( psz_message, i_message );
573 strcat( psz_message, " : " );
574 strcat( psz_message, message->psz_value );
575 strcat( psz_message, STRING_CR );
579 i_message += sizeof( STRING_CR );
580 psz_message = realloc( psz_message, i_message );
581 strcat( psz_message, STRING_CR );
584 for( i = 0; i < message->i_child; i++ )
586 char *child_message =
587 MessageToString( message->child[i], i_level + 1 );
589 i_message += strlen( child_message );
590 psz_message = realloc( psz_message, i_message );
591 strcat( psz_message, child_message );
592 free( child_message );
595 if( i_level == 0 ) strcat( psz_message, STRING_TAIL );